Sync and explore your Claude Code sessions. Connect confab to your Confab backend to capture transcripts in real-time for exploration, sharing, and analysis.
Works seamlessly — your claude workflow stays exactly the same.
Supported on macOS and Linux.
curl -fsSL https://raw.githubusercontent.com/ConfabulousDev/confab/main/install.sh | bash
# Follow the instructions to add confab to your PATH
confab setup --backend-url https://confab.yourcompany.comAfter setup, your Claude Code sessions will automatically sync to the configured backend.
# Initial setup — configures backend, authenticates, and installs hooks
confab setup --backend-url https://confab.yourcompany.com
# Login separately (if already set up)
confab login --backend-url https://confab.yourcompany.com
# Check connection and hook status
confab status
# Logout
confab logoutTo deploy your own Confab backend, see confab-web.
Sessions are synced incrementally while you work:
# Install sync hooks (done automatically by setup)
confab hooks add
# View running sync daemons
confab sync status
# Remove hooks
confab hooks removeThe sync daemon uploads transcript data periodically during your session, so data isn't lost if the session ends unexpectedly.
# List all local sessions
confab list
# Filter by duration
confab list -d 5d # Sessions from last 5 days
confab list -d 12h # Sessions from last 12 hoursCopy a session ID from the list to use with confab save.
# Upload specific sessions by ID (use IDs from 'confab list')
confab save abc123de
# Upload multiple sessions
confab save abc123de f9e8d7c6Sensitive data is automatically redacted before uploading. Redaction is enabled by default during confab setup.
Built-in patterns detect common secrets (API keys, private keys, JWT tokens, database passwords, and more) without any configuration.
See Redaction for configuration details.
| File | Purpose |
|---|---|
~/.confab/config.json |
Backend URL, API key, and redaction settings |
~/.confab/logs/confab.log |
Operation logs (auto-rotated, 14 day retention) |
| Variable | Default | Purpose |
|---|---|---|
CONFAB_CLAUDE_DIR |
~/.claude |
Claude Code state directory |
CONFAB_CONFIG_PATH |
~/.confab/config.json |
Config file location |
CONFAB_LOG_DIR |
~/.confab/logs |
Log directory |
Each package has a README with extension guides, invariants, and design decisions:
See also CLAUDE.md for AI-oriented architecture notes and development practices.
make build
go test ./...git clone https://github.com/ConfabulousDev/confab.git
cd confab
make build
./confab install
# Follow the instructions to add confab to your PATH
confab setup --backend-url https://confab.yourcompany.comMIT
