Confabulous
ConfabulousDev/confab-web
Analytics e gestão de sessões Claude, 100% auto-hospedado no Docker
Ver no GitHubPlataforma de gerenciamento e análise de sessões do Claude Code e Codex, com arquivamento, busca, recaps com IA e recursos de compartilhamento. Auto-hospedada em Docker com autenticação multi-usuário, análise de custos e painel administrativo completo.
Instalação
npx convez-ai ConfabulousDev/confab-web1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Arquivar e pesquisar sessões de codificação com Claude Code
- Rastrear custos e análises de uso de IA
- Compartilhar sessões de forma controlada em equipes
- Manter propriedade total dos dados de desenvolvimento
Veredito

Solução robusta e bem-pensada para quem trabalha com Claude Code e precisa de observabilidade sem ceder dados. A arquitetura Docker simplificada e as opções de autenticação flexíveis (OAuth, OIDC) a tornam pronta para produção em qualquer ambiente corporativo.
README
A tradução para o português deste README ainda está na fila.
Confabulous
Self-hosted analytics for your Claude Code and Codex sessions.
Open-source, self-hosted platform for archiving, searching, and analyzing your Claude Code and Codex sessions. Runs entirely in Docker on your own infrastructure.
[!IMPORTANT] Code sessions contain proprietary code, architecture decisions, and internal workflows. The self hosted Confabulous stack keeps all of it on your network — no third-party access, no vendor lock-in.
[!TIP] No login required — see Confabulous in action at demo.confabulous.dev.
[!TIP] Don't want to self-host? Use the free, fully featured managed instance at confabulous.dev — no install required.
Quickstart
Run your own instance in under a minute with the Self-Hosting Guide: one docker-compose.yml, docker compose up -d, and the dashboard is live at http://localhost:8080 (admin@local.dev / localdevpassword).
Developing against the code? See Local Development.
Connect the CLI
Install the Confab CLI and point it at your instance:
curl -fsSL https://raw.githubusercontent.com/ConfabulousDev/confab/main/install.sh | bash
confab setup --backend-url http://localhost:8080
Start a Claude Code or Codex session — it appears in the dashboard automatically.
Features
- Session Management — Archive, browse, search sessions; full transcript viewer
- Analytics & Smart Recaps — Cost tracking, AI-powered recaps (requires Anthropic API key)
- Sharing — Fine-grained session-by-session sharing, or open sharing policy for self-hosted high-trust deployments
- Multi-User Auth — Password auth, GitHub OAuth, Google OAuth, or OIDC (Okta, Auth0, Azure AD, Keycloak)
- Admin Panel — User management, activation/deactivation, storage monitoring
- Developer Experience — GitHub link detection, API keys, per-user rate limiting
- Infrastructure — Single Docker image (frontend + backend), Docker Compose one-command deploy, PostgreSQL + MinIO, custom domain support
How It Works
Self-Hosting
See the Self-Hosting Guide for complete deployment instructions including HTTPS setup, authentication options, and production hardening.
Configuration
Configuration is simple — everything is controlled through environment variables. See CONFIGURATION.md for the full reference.
Deploying to a Cloud Host
Two production reference deployments:
- Linode + Docker Compose + Caddy —
confab-demo-site(OpenTofu, compose, Caddyfile, deploy script) powers demo.confabulous.dev for $7/mo. - Fly.io + Neon —
deploy-to-fly.shandfly.tomlpower confabulous.dev.
Developer Docs
Project Guides
CLAUDE.md-- Development workflow, testing, coding conventionsCONFIGURATION.md-- Full environment variable referenceSELF-HOSTING.md-- Deployment, HTTPS, auth setup, production hardening
Backend
backend/API.md-- REST API reference (endpoints, request/response schemas, auth)backend/internal/README.md-- Package index, dependency map, data flow, layering rules
Frontend
frontend/src/README.md-- Module index, data flow, architectural patterns
Local Development
One path: infra in Docker, backend and frontend native for hot reload. Everything runs through the root Makefile — make help lists every target.
Prerequisites: Docker & Docker Compose, Go 1.26+, Node.js 24+.
make setup # first run only: creates backend/.env, installs frontend deps
make dev # infra + backend + frontend in one terminal (Ctrl-C stops all)
Open http://localhost:5173 and log in with admin@example.com / change-me-immediately (from backend/.env).
Prefer separate terminals? Run the pieces on their own:
make up # infra (Postgres + MinIO) + migrations
make backend # backend → http://localhost:8080
make frontend # frontend → http://localhost:5173
Running Tests
make test # backend + frontend
make coverage # backend coverage (sharded)
Project Structure
confab-web/
├── docker-compose.yml # Local dev infrastructure (Postgres + MinIO + migrate)
├── CONFIGURATION.md # Full configuration reference
├── backend/ # Backend service (Go)
│ ├── cmd/server/ # Server entry point
│ ├── internal/ # Internal packages
│ │ ├── api/ # HTTP handlers
│ │ ├── auth/ # OAuth & API keys
│ │ ├── db/ # PostgreSQL layer
│ │ ├── storage/ # MinIO/S3 client
│ │ └── testutil/ # Test infrastructure
│ └── README.md
│
└── frontend/ # React web dashboard
├── src/pages/ # Pages and routes
├── src/services/ # API client
└── README.md
See also: Confab CLI (separate repo)