Claude Plugin Cxdb Integration — Development skill for Claude Code

cxdb Claude Code Observability Plugin

Records every [Claude Code](https://claude.ai/code) session as structured turns in [cxdb](https://github.com/strongdm/cxdb) — a turn-DAG context store for AI agent trajectories. Browse full session histories, tool calls, token usage, and reasoning in the cxdb UI.

Requirements

• Claude Code (any recent version)
• bash, curl, jq, python3 (standard on macOS and most Linux)
• A running cxdb instance (local Docker or shared Tailscale instance)

Quick Start

1. Start cxdb

In the [cxdb repo](https://github.com/strongdm/cxdb):

make dev-docker-up

Starts cxdb in Docker. Frontend at http://localhost:9080 · API at http://localhost:9010

2. Install the plugin

git clone https://github.com/prime-radiant-inc/claude-plugin-cxdb-integration
cd claude-plugin-cxdb-integration
make install

3. Start a new Claude Code session

Sessions started **after** installation are recorded automatically. Open http://localhost:9080 to watch them appear in real time.

How It Works

Seven Claude Code hooks record the full session lifecycle:

Hook	cxdb item_type	Notes
SessionStart	system (info)	Creates context, publishes type bundle, writes ContextMetadata + Provenance
UserPromptSubmit	user_input	Captures user message text (async)
PostToolUse	(buffered)	Buffers tool call + result to session state — no cxdb write yet
Stop	assistant_turn	Flushes buffered tool calls; parses transcript for text + token metrics
SubagentStop	handoff	Records agent-to-agent handoffs for Task tool calls
PreCompact	system (warning)	Notes when context window compaction occurs (async)
Notification	system (info)	Records Claude Code notifications (async)

Tool call results are captured per tool type — each tool's response has a different structure:

Tool	Content captured
Bash	stdout (+ stderr if non-empty)
`Read