Files
AgentHub/vscode-extension/README.md
T
nntrivi2001 e972267a42 fix(plugins): make the 10 focused plugins installable, finish the AgentHub rename
The ten `agenthub-*` plugins were listed by the marketplace but could never be
installed — two schema mistakes present since the entries were first authored
(57dc915), both invisible until you actually run `claude plugin install`:

- marketplace entries used `"path": "plugins/<name>"`; the CLI only accepts
  `"source"`, so every one failed with
  `This plugin's marketplace entry is invalid: source: Invalid input`
- each `plugin.json` carried npm's `"repository": { "type", "url" }` object;
  the schema wants a plain string, so the next attempt failed with
  `Validation errors: repository: Invalid input`

Verified by installing all 11 entries into a throwaway CLAUDE_CONFIG_DIR:
1/11 before, 11/11 after. `plugins-marketplace.test.js` was asserting the
broken shape, which is why CI stayed green — it now asserts `source` and
rejects `path`.

Marketplace renamed `claude-code-agent-monitor-plugins` -> `agenthub`, so the
install line is `agenthub@agenthub`. ARCHITECTURE.md documented a marketplace
name (`smartgift-claude-code-monitor`) that never existed in any revision.

The documented `/plugin marketplace add Smartgift-AI/Claude-Code-Monitor` also
never worked: the `owner/repo` shorthand resolves to github.com only, and this
repo is self-hosted on Gitea. Confirmed the CLI rejects `host/owner/repo` and
ignores GH_HOST / GITHUB_HOST / CLAUDE_CODE_MARKETPLACE_URL, so the full
https:// clone URL is the only supported form. Same GitHub-habit class fixed
elsewhere: raw.githubusercontent.com icon URLs (404, and the repo ships
favicon.svg not favicon.ico — the client had the same dead /favicon.ico),
a smartgift.github.io docs link (404), and Gitea `/blob/<ref>/` paths that
must be `/src/branch/<ref>/`.

Repository renamed to Smartgift-AI/AgentHub throughout. Gitea 301-redirects
the old name, so these were stale rather than broken; `docs/superpowers/`
keeps the old name because those are dated decision records.

Adds `repo-links.test.js` to guard both classes (it runs under the existing
pre-commit gate) plus an openapi.yaml drift check — the committed spec had
silently fallen a minor version behind package.json. `generate-openapi-yaml.js`
now exports `render()` so the test compares against one definition of the dump
options instead of a second copy.
2026-09-10 11:03:14 +07:00

2.5 KiB

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.

Extension Screenshot


🚀 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:

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:
    npm install -g @vscode/vsce
    
  2. Navigate to the extension folder:
    cd vscode-extension
    
  3. Run the package command:
    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.