by agentlogs
Collaboration in the age of agentic engineering
# Add to your Claude Code skills
git clone https://github.com/agentlogs/agentlogsAgentLogs captures and analyzes transcripts from AI coding agents (like Claude Code, Codex, OpenCode, and Pi) to give your team visibility into how AI tools are used in their codebases.
See it in action → Example transcript
AI coding agents are becoming core to how teams write software. But right now, every session is a black box stored on the machine of the user. You can't see the context put into each session and there is no knowledge sharing between teammates.
AgentLogs fixes that:
| Team Dashboard | Git Integration | Session Browser |
| --------------------------------------------------------- | --------------------------------------------- | ----------------------------------------------- |
|
|
|
|
| Agent | Transcripts | Auto-sync | Commit Tracking | | -------------------------------------------------------------- | ----------- | --------- | --------------- | | Claude Code | ✓ | ✓ | ✓ | | Cline (experimental) | ✓ | ✓ | ✓ | | | ✓ | ✓ | ✓ | | | ✓ | ✓ | ✓ | | | ✓ | ✓ | ✓ |
No comments yet. Be the first to share your thoughts!
npx agentlogs login agentlogs.ai
Claude Code — inside Claude Code:
/plugin marketplace add agentlogs/claude-code
/plugin install agentlogs
Cline:
npx agentlogs cline install
Codex:
Run npx agentlogs codex install to write ~/.codex/hooks.json, enable Codex hook capture, and track git commits in AgentLogs.
Set AGENTLOGS_CLI_PATH='bun /absolute/path/to/packages/cli/src/index.ts' before starting Codex if you want hooks to use a local AgentLogs checkout while developing.
Codex does not currently let hooks rewrite the commit message body, so transcript URLs are not appended to commit messages automatically.
See the full setup guide: https://agentlogs.ai/docs/agents/codex
OpenCode — add to opencode.json:
{ "plugin": ["@agentlogs/opencode"] }
Pi — run inside Pi or from the terminal:
pi install npm:@agentlogs/pi
Transcripts are captured and uploaded automatically. View them at agentlogs.ai.
The CLI can also be used standalone for manual uploads:
# Interactive picker, browse transcripts from all agents
npx agentlogs upload
# Upload most recent transcript
npx agentlogs upload --latest
# Sync all Claude Code transcripts
npx agentlogs claudecode sync
# Check auth status
npx agentlogs status
See the full CLI reference.
AgentLogs is source-available and can be self-hosted.
You can deploy it either as:
ghcr.io/agentlogs/agentlogsagentlogs-server binary from GitHub ReleasesSee the full guide at Hosting Docs.
https://your-domain.examplehttps://your-domain.example/api/auth/callback/githubhttp://localhost:3000 and http://localhost:3000/api/auth/callback/githubGITHUB_CLIENT_IDGITHUB_CLIENT_SECRETBETTER_AUTH_SECRET (generate with openssl rand -base64 32)WEB_URL (public app URL, e.g. https://logs.example.com)Requires Bun v1.3.10.
git clone https://github.com/agentlogs/agentlogs.git
cd agentlogs
bun install
# Configure environment
cp packages/server/.env.example packages/server/.env
# Edit packages/server/.env with:
# GITHUB_CLIENT_ID=...
# GITHUB_CLIENT_SECRET=...
# BETTER_AUTH_SECRET=... (openssl rand -base64 32)
# WEB_URL=http://localhost:3000
# Initialize database
bun db:migrate
# Start
bun dev
Open http://localhost:3000.
Point the CLI at your local instance:
npx agentlogs login localhost:3000
docker run -d \
--name agentlogs \
-p 3000:3000 \
-v agentlogs-data:/app/.data \
-e GITHUB_CLIENT_ID=... \
-e GITHUB_CLIENT_SECRET=... \
-e BETTER_AUTH_SECRET=... \
-e WEB_URL=https://logs.example.com \
ghcr.io/agentlogs/agentlogs:latest
Download the correct binary for your OS/architecture from GitHub Releases:
chmod +x ./agentlogs-server
./agentlogs-server
By default, the standalone server applies embedded migrations before startup. Use --no-migrations to skip them or --only-migrations to run them and exit.
npx agentlogs login logs.example.com
packages/
├── cli/ — CLI tool (npx agentlogs)
├── server/ — Server package (TanStack Start web UI + API, standalone Bun binary + SQLite)
├── shared/ — Shared types, schemas, transcript parsing, secret redaction
├── pi/ — Pi extension (@agentlogs/pi)
├── opencode/ — OpenCode plugin (@agentlogs/opencode)
└── e2e/ — End-to-end tests
docs/ — Documentation (Mintlify)
# Start the server package
bun dev
# Run CLI
bun agentlogs
# Type check, lint, format
bun run check
# Format code
bun run format
# Run e2e tests
bun run test:e2e
# Database commands
bun db:migrate # Run migrations
bun db:generate # Generate migrations from schema changes
bun db:studio # Open Drizzle Studio
bun db:reset # Reset local database
We welcome contributions! Please:
bun run format and bun run checkAgentLogs was inspired by and builds on ideas from: