nntrivi2001
17d56d0e01
Clean break, no compatibility alias. Renames the product name, the CLI binary (`ccam` -> `agenthub`), the env var prefix (`CCAM_` -> `AGENTHUB_`), the Prometheus metric namespace (`ccam_*` -> `agenthub_*`), the tmux session prefix (`ccam-lane-<id>` -> `agenthub-lane-<id>`), the per-repo runtime profile directory (`.ccam/profile` -> `.agenthub/profile`), the lanes state root (`~/.claude/ccam-lanes` -> `~/.claude/agenthub-lanes`), the bundled plugins (`plugins/ccam*` -> `plugins/agenthub*`) and their slash commands (`/ccam-doctor` -> `/agenthub-doctor`, `/ccam:*` -> `/agenthub:*`). Because there is no alias, an existing install has to be updated by hand: rename its `.ccam/profile` directory and any `CCAM_*` variables, and reinstall the plugin under its new name. Two other name families are deliberately left alone here, since they are not just strings: the `Claude-Code-Monitor` repository/marketplace name, and the `agent-dashboard` npm package plus its `~/.claude/agent-dashboard` runtime directory, which holds the live database and needs a migration rather than a rename. Verified: server 1406/1406, client 459/459, `grep -i ccam` clean across tracked files, `openapi.yaml` regenerated (95 paths, unchanged count).
80 lines
2.5 KiB
Markdown
80 lines
2.5 KiB
Markdown
# AgentHub for VS Code
|
|
|
|
**AgentHub** brings a high-fidelity, real-time dashboard for your Claude Code AI sessions directly into your VS Code workspace. Monitor token usage, track agent health, and view deep analytics without switching windows.
|
|
|
|
|
|
|
|
---
|
|
|
|
## 🚀 Key Features
|
|
|
|
### 📊 Integrated Dashboard
|
|
Open the full agent monitoring dashboard in a dedicated VS Code tab. Supports real-time updates via WebSockets and local-first data storage.
|
|
|
|
### 🩺 Live Agent Health
|
|
Track all 5 agent states in your sidebar with color-coded status indicators:
|
|
- **Working**: Active subagents currently processing tasks.
|
|
- **Connected**: Agents initialized and ready.
|
|
- **Idle**: Standby agents.
|
|
- **Completed**: Successfully finished tasks.
|
|
- **Error/Failed**: Instantly spot where things went wrong.
|
|
|
|
### 📈 Usage & Analytics
|
|
- **Token Tracking**: Real-time display of Billions (B) or Millions (M) of tokens consumed.
|
|
- **Cost Calculation**: Live estimate of total USD cost based on current model pricing.
|
|
- **Event Frequency**: High-signal stats on events per session and subagent spawning.
|
|
|
|
### 🧭 Deep Navigation
|
|
Jump directly to specific views from the sidebar:
|
|
- **Main Dashboard**: Global overview.
|
|
- **Analytics Hub**: Deep dives into model performance.
|
|
- **Agent Board**: Kanban-style view of subagent progress.
|
|
- **Recent Sessions**: One-click access to your last 10 Claude sessions.
|
|
|
|
---
|
|
|
|
## 🛠️ Getting Started
|
|
|
|
### 1. Requirements
|
|
Ensure you have the AgentHub server running locally:
|
|
```bash
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
### 2. Installation
|
|
- Search for **"AgentHub"** in the VS Code Marketplace.
|
|
- Click **Install**.
|
|
|
|
### 3. Usage
|
|
- Click the **Radar/Dashboard icon** in the Activity Bar.
|
|
- The extension automatically detects your local server on ports **5173** (dev) or **4820** (prod).
|
|
- Use the **Refresh** button in the sidebar to manually force an update.
|
|
|
|
---
|
|
|
|
## 📦 Publishing & Development
|
|
|
|
To generate a `.vsix` file for manual installation or marketplace upload:
|
|
|
|
1. Install `vsce` globally:
|
|
```bash
|
|
npm install -g @vscode/vsce
|
|
```
|
|
2. Navigate to the extension folder:
|
|
```bash
|
|
cd vscode-extension
|
|
```
|
|
3. Run the package command:
|
|
```bash
|
|
vsce package
|
|
```
|
|
*This will generate `claude-code-agent-monitor-1.0.0.vsix`.*
|
|
|
|
---
|
|
|
|
## 📜 License
|
|
Internal SmartGift build — all rights reserved.
|
|
|
|
Developed with ❤️ for the AI Engineer community.
|