Sidekick Agent Hub

Multi-provider AI coding assistant for VS Code — inline completions, code transforms, commit messages, and agent session monitoring.

AI coding agents are powerful, but they run autonomously — tokens burn silently, context fills up without warning, and everything is lost when a session ends. Sidekick gives you real-time visibility into what your agent is doing, AI-powered coding features that eliminate mechanical work, and session intelligence that preserves context across sessions.

What's New

• Codex reset credits — the dashboard "Rate Limits" tile now shows available rate-limit reset credits and their expirations, resolving Codex quota API-first with local fallback.
• z.ai Coding Plan quota — when OpenCode has z.ai Coding Plan credentials, the dashboard adds a z.ai quota card (5-Hour / Weekly) sourced from z.ai's quota API, with cached snapshot fallback.
• Claude Opus 4.8 & Fable 5 — full support for Anthropic's latest flagships, including 1M-token context windows, accurate pricing, and "Fable" display labels in model pickers.
• Richer conversation view — the transcript now interleaves assistant reasoning, tool calls, and narration in provider-normalized arrival order (a compact Process + Answer shape) for Claude, Codex, and OpenCode sessions.
• Session asset extraction — Sidekick: Extract Session Assets searches recent chats for URLs, files, commands, and plans, then opens or copies them from a native QuickPick.
• Quota-history heatmap — a 13-week, per-workspace, GitHub-style view of session-limit utilization in the dashboard.
• Multi-account management — sign in to new Claude Code and Codex accounts, switch across all saved accounts from one picker (status bar menu or Command Palette), and opt into quota-based auto-switching via the sidekick.accounts.autoSwitchThreshold setting.

See the full changelog for everything.

Quick Start

Claude Max (Recommended)

1. Install and authenticate Claude Code CLI:

   npm install -g @anthropic-ai/claude-code
   claude auth
   

2. Install the extension from the VS Code Marketplace or Open VSX
3. Start typing — completions appear as ghost text

Claude API

1. Install the extension
2. Run "Sidekick: Set API Key" from the Command Palette
3. Set sidekick.inferenceProvider to claude-api

OpenCode

1. Ensure OpenCode is running (opencode in a terminal)
2. Set sidekick.inferenceProvider to opencode

Note: OpenCode session monitoring reads opencode.db and currently expects an executable sqlite3 runtime in the host environment.

Codex CLI

1. Install Codex CLI: npm install -g @openai/codex
2. Set OPENAI_API_KEY or CODEX_API_KEY
3. Set sidekick.inferenceProvider to codex

Features

AI Coding

Let AI handle the mechanical work — boilerplate, commit messages, docs, PR descriptions — so you focus on design and logic.

• Inline Completions — context-aware suggestions that understand your project, not just syntax (Ctrl+Shift+Space to trigger manually)
• Code Transforms — select code, describe changes in natural language (Ctrl+Shift+M)
• Generate Documentation — auto-generate JSDoc/docstrings from implementation, not just signatures (Ctrl+K Ctrl+G)
• Explain Code — five complexity levels from ELI5 to PhD Mode (Ctrl+K Ctrl+E)
• Quick Ask — inline chat for questions and code changes (Ctrl+K Ctrl+A)
• AI Commit Messages — generate meaningful messages from staged changes (sparkle icon in SCM toolbar)
• Pre-commit Review — catch bugs, security concerns, and code smells before they reach your team (eye icon in SCM toolbar)
• PR Descriptions — auto-generate structured summaries from branch diff (PR icon in SCM toolbar)
• Error Analysis — AI-powered error explanations and one-click fixes

Agent Monitoring

When your AI agent runs autonomously, you need to know what it's doing. Real-time dashboards, visualizations, and alerts keep you in control.

• Session Analytics Dashboard — real-time token usage, costs, context attribution, activity timeline

• Mind Map — interactive D3.js graph of session structure and file relationships

• Kanban Board — task and subagent tracking with real-time updates

• Project Timeline — chronological view of all sessions with duration, token usage, and expandable details

• HTML Session Report — self-contained HTML report with full transcript, token/cost stats, model breakdown, and tool-use summary — opens in a webview panel or browser

• Analytics Charts — tool frequency, event distribution, activity heatmap, and event pattern detection in the dashboard

• Event Stream — live sidebar tree view of session events with color-coded type icons and timestamps

• Conversation Viewer — full session transcript that interleaves assistant reasoning, tool calls, and narration in provider-normalized arrival order (a compact Process + Answer shape) for Claude, Codex, and OpenCode; tool calls render as concise rows with expandable outputs, with search across the conversation
• Tool Inspector — per-tool rendering (diffs for Edit, commands for Bash, etc.) with paired tool outputs (file content, stdout, search results)
• Subagent Tree — hierarchical view of subagent spawns with nested parent/child relationships
• Plans Board — agent plans discovered for the project, surfaced as a dedicated sidebar view
• Latest Files Touched — sidebar tree of files the current session has read or modified
• Cross-Session Search — search across all sessions
• Notification Triggers — alerts for credential access, destructive commands, compaction, token thresholds
• Provider Status — live API health indicator scoped to the monitored provider: Claude for Claude Code sessions, OpenAI for Codex sessions, hidden for OpenCode unless you run the standalone status command

Session Intelligence

• Knowledge Notes — capture gotchas, patterns, guidelines, and tips attached to files, with lifecycle tracking and instruction file injection

• Session Handoff — automatic context documents for session continuity
• Decision Log — tracks architectural decisions from sessions
• CLAUDE.md Suggestions — AI-powered session analysis for optimizing agent instructions
• Extract Session Assets — run Sidekick: Extract Session Assets to search recent Claude Code and Codex chats for URLs, files, commands, and plans. URLs open externally, file paths open in the editor, commands copy to the clipboard, and plans open as Markdown

• Event Logging — optional JSONL audit trail for debugging

Terminal Dashboard

All monitoring and intelligence features are also available as a standalone terminal dashboard — no VS Code required.

Note: The npm package is sidekick-agent-hub, but the binary is called sidekick.

npm install -g sidekick-agent-hub    # requires Node.js 20+
sidekick dashboard

Browse sessions, tasks, decisions, knowledge notes, live event streams, and charts in a full-screen TUI. Eight panels including an Events panel for real-time session activity and a Charts panel with tool frequency, event distribution, activity heatmap, and pattern analysis. Press ? for keybindings. Standalone commands (sidekick tasks, sidekick decisions, sidekick notes, sidekick stats, sidekick handoff, sidekick search, sidekick context, sidekick extract, sidekick status) jump directly to a specific panel or run one-shot queries. See the CLI Dashboard docs for the full guide.

Key Settings

Model settings accept auto (recommended), a tier (fast/balanced/powerful), a legacy name (haiku/sonnet/opus), or a full model ID. Tiers resolve to current flagships — including Claude Opus 4.8 and Fable 5 with 1M-token context windows where available. See Model Resolution for details.

Commands

Troubleshooting

No completions? Click "Sidekick" in the status bar → "Test Connection" to verify provider connectivity.

CLI not found? Set sidekick.claudePath to the full path (find with which claude).

OpenCode issues? Ensure OpenCode is running and listening on port 4096. If session monitoring is still unavailable, verify sqlite3 is executable in the same environment as VS Code because OpenCode session discovery reads opencode.db.

Codex issues? Verify OPENAI_API_KEY or CODEX_API_KEY is set.

Full Documentation

For detailed guides, configuration reference, and architecture docs, visit the documentation site.

See Also

sidekick-shared — the shared data access library, published as a standalone npm package. Types, parsers, session providers, event aggregation, model pricing, actionable session-asset extraction, and more — for building custom tools on Sidekick session data without depending on VS Code. Install with npm install sidekick-shared.

Sidekick Docker — real-time Docker management dashboard as a VS Code extension and CLI. Monitor containers, Compose projects, images, volumes, and networks with vi keybindings and live-streaming stats.

Community

If Sidekick is useful to you, a star on GitHub helps others find it.

Found a bug or have a feature idea? Open an issue — all feedback is welcome.

License

MIT