Sidekick Agent Hub¶

AI coding assistant with real-time agent monitoring — VS Code extension and terminal dashboard.

What Sidekick Does For You¶

Code faster. AI handles the mechanical work — boilerplate, commit messages, docs, PR descriptions, error explanations — so you focus on design and logic. Inline completions understand your project context, not just syntax.

Stay in control. When AI agents run autonomously, tokens burn silently and context fills up without warning. Sidekick's real-time dashboards, mind maps, and notification triggers give you visibility into what your agent is doing, so you can catch problems before you hit limits.

Track project momentum. The Project Timeline shows every session your agent has run — durations, token costs, tasks completed — so you can see progress at a glance and understand how your project is evolving across sessions.

Build a knowledge base. Capture gotchas, patterns, guidelines, and tips attached to specific files. Knowledge notes persist across sessions and can be injected into your agent's instruction file so it stops rediscovering the same things.

Never lose context. Sessions end and everything is lost — decisions, progress, architectural choices. Session handoff and decision logging preserve that context automatically, so your next session picks up where you left off instead of re-discovering everything.

Monitor from the terminal. The Sidekick CLI provides a full-screen TUI dashboard for monitoring agent sessions without leaving the terminal. Browse sessions, tasks, decisions, knowledge notes, and more — all rendered in an Ink-based terminal UI. Install with npm install -g sidekick-agent-hub and run sidekick dashboard. Works with Claude Code, OpenCode, and Codex sessions.

Why Am I Building This?¶

AI coding agents are the most transformative tools I've used in my career. They can scaffold entire features, debug problems across files, and handle the mechanical parts of software engineering that used to eat hours of every day.

But they're also opaque. Tokens burn in the background with no visibility. Context fills up silently until your agent starts forgetting things. And when a session ends, everything it learned — your architecture, your conventions, the decisions you made together — is just gone. The next session starts from zero.

That bothers me. I want to see what my agent is doing. I want to review every tool call, understand where my tokens went, and carry context forward instead of losing it. Sidekick exists because I think the people using these agents deserve visibility into how they work — not just the output, but the process.

Supported Providers¶

Provider	Inference	Session Monitoring	Cost
Claude Max			Included in subscription
Claude API			Per-token billing
OpenCode			Depends on configured provider
Codex CLI			OpenAI API billing

Feature Highlights¶

VS Code Extension¶

• Inline Completions — context-aware suggestions that understand your project, not just syntax
• Code Transforms — select code, describe changes in natural language
• AI Commit Messages — meaningful messages generated from your actual diff
• Quick Ask — inline chat for questions and code changes without switching context
• Code Review — catch bugs and security concerns before they reach your team
• PR Descriptions — structured summaries from branch diff, ready to paste
• Error Analysis — understand what went wrong, why, and how to fix it, with color-coded explanation sections and one-click Apply Fix
• Session Handoff — pick up where you left off instead of re-discovering everything
• Accessibility — prefers-reduced-motion support, keyboard navigation, ARIA landmarks, and focus-visible indicators across all panels
• CLAUDE.md Suggestions — learn from session patterns to improve agent effectiveness
• Context Health — track how much information your agent has lost to context compaction
• Truncation Detection — know when tool outputs are silently cut short
• Cycle Detection — get alerted when your agent enters repetitive loops
• Provider Status — live API health scoped to the monitored provider: Claude for Claude Code sessions, OpenAI for Codex sessions, hidden for OpenCode
• Multi-Account Switching — save and switch between Claude Code accounts without manual login cycles

VS Code + CLI Dashboard¶

Available in the VS Code extension and the CLI Dashboard. The CLI works standalone — no VS Code extension required.

• Session Monitor — see exactly where your tokens are going before you hit quota limits
• Mind Map — trace how your agent navigated the codebase, with cycling file and goal-gate indicators
• Kanban Board — track tasks and subagents at a glance, with goal-gate badges on critical tasks
• Project Timeline — chronological view of all sessions with duration, token usage, and expandable details
• Knowledge Notes — capture gotchas, patterns, guidelines, and tips attached to files, with lifecycle tracking
• HTML Session Report — self-contained HTML report with full transcript, token/cost stats, and tool-use breakdown

Quick Install¶

VS Code Extension¶

Install from the VS Code Marketplace or Open VSX. Then see Getting Started for provider setup.

CLI Terminal Dashboard¶

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

npm install -g sidekick-agent-hub
sidekick dashboard

Requires Node.js 20+. Works standalone — no VS Code required. See CLI Dashboard for the full guide.

Shared Library¶

Building your own tool on top of Sidekick session data? The sidekick-shared npm package provides types, parsers, session providers, event aggregation, model pricing, Zod schemas, and more — no VS Code or CLI dependency required.

npm install sidekick-shared

See the Architecture Overview for what's included.

See Also¶

Sidekick Docker — a sibling project that brings the same real-time dashboard experience to Docker management. Monitor containers, Compose projects, images, volumes, and networks from a keyboard-driven TUI or VS Code panel. Available as a VS Code extension, Open VSX extension, and CLI.

Contributing¶

Contributions welcome! See the Contributing Guide.

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