# AgentHarbor > ๐Ÿšข One native tray app for all your AI coding agents โ€” live rate limits, session usage & monthly spend for Claude Code, Cursor, Codex, Gemini CLI & Windsurf, plus one-click MCP/rules/skills/sub-agent deploy. - **Type:** MCP server - **Install:** `agentstack add mcp-abhiunix-agentharbor` - **Verified:** Yes โ€” security-reviewed for prompt injection and unsafe behavior - **Seller:** [abhiunix](https://agentstack.voostack.com/s/abhiunix) - **Installs:** 0 - **Category:** [Integrations](https://agentstack.voostack.com/c/integrations) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [abhiunix](https://github.com/abhiunix) - **Source:** https://github.com/abhiunix/AgentHarbor - **Website:** https://agentharbor.openxsecurity.com ## Install ```sh agentstack add mcp-abhiunix-agentharbor ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # AgentHarbor **One tray app to manage all your AI coding agents.** For developers running Claude Code, Cursor, Codex, Gemini CLI, or Windsurf: track usage and spend, manage configurations, deploy capabilities, and keep every tool in sync โ€” all from one native app. [](https://github.com/abhiunix/AgentHarbor/releases/latest) [](https://github.com/abhiunix/AgentHarbor/releases) [](https://github.com/abhiunix/AgentHarbor/releases/latest) [](https://github.com/abhiunix/AgentHarbor/releases/latest) [](LICENSE) [](https://tauri.app) [](https://www.rust-lang.org) [](https://react.dev) [](https://www.typescriptlang.org) [](https://tailwindcss.com) [**Website**](https://agentharbor.openxsecurity.com) ยท [**Download**](https://github.com/abhiunix/AgentHarbor/releases/latest) ยท [**Getting Started**](docs/getting-started.md) ยท [**Features**](docs/features.md) ยท [**Docs**](docs/) --- ## What is it? AgentHarbor is an AI coding agent manager โ€” a native tray app for macOS and Windows that sits quietly in your menu bar / system tray while you code. It shows you real-time rate limits, session usage, and monthly spend for every AI provider you use โ€” without opening a browser or running CLI commands. When you want to deploy an MCP server, rule, skill, or sub-agent across Claude Code, Cursor, and Windsurf at once, a guided wizard handles the diffs, backups, and atomic writes for you. --- ## Why AgentHarbor? Tools like [ccusage](https://github.com/ryoppippi/ccusage) and [Claude Code Usage Monitor](https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor) do one job very well: if you want a terminal-based Claude Code usage monitor, use them. AgentHarbor is built for a different job โ€” an always-on desktop app that watches **all** your providers and also manages the config files they read. | | AgentHarbor | ccusage | Claude Code Usage Monitor | |---|---|---|---| | Interface | Native tray app (macOS / Windows) | CLI | Terminal UI | | Providers | Claude Code, Cursor, Codex, Gemini CLI, Windsurf | Claude Code | Claude Code | | Spend tracking | Per-provider, incl. API-equivalent cost engine | Claude Code cost reports | Claude Code cost projections | | MCP / rules / skills / sub-agent deploy | โœ… guided wizard with diffs, backups, undo | โ€” | โ€” | | Drift detection | โœ… hash-based, with side-by-side review | โ€” | โ€” | | Local-only (no telemetry) | โœ… | โœ… | โœ… | --- ## Features - **Live tray analytics** โ€” menu-bar metric updates every ~120 s: session percentage, monthly spend, quota bars โ€” whichever is most relevant for each provider. - **Limit-state ladder** โ€” tracks `Unauthenticated โ†’ ApiDisabled โ†’ BillablePaused โ†’ SubscriptionIssue โ†’ RateLimited โ†’ Reached โ†’ Approaching โ†’ Healthy` and surfaces native macOS notifications on transitions. - **Deploy wizard** โ€” syntax-highlighted split/unified diffs, per-file `Replace / Merge / Append` strategy, automatic backups before every write. - **Undo Deploy** โ€” one click restores the pre-deploy snapshot from the backup store. - **Presets** โ€” bundle any set of capabilities for one-click deploy; ships with `Full-Stack Web` and `Data Science` examples. - **Drift detection** โ€” keeps MCP config sync honest across editors: detects when a teammate or another tool changes a managed file and shows a side-by-side diff with Accept or Restore. - **Cost engine** โ€” per-model API-equivalent costs for Claude (Opus / Sonnet / Haiku) and Codex (GPT-5 / 4 / 3.5), token-deduplicated across session windows. - **Secrets manager** โ€” stores sensitive env vars in the macOS Keychain and injects them into MCP `env` blocks at deploy time. - **Auto-update** โ€” Tauri updater checks GitHub Releases every 4 hours; in-app banner with one-click install and optional 24 h snooze. - **Native macOS** โ€” Keychain integration, system tray popover with click-through, optional menu-bar-only mode, native notifications. --- ## Supported providers | Provider | Analytics | Rate limits / spend | Deploy targets | |---|---|---|---| | **Claude Code** | Full (Pro / Max / Enterprise) | Session 5h, Weekly, Sonnet/Opus, monthly $ | MCP, skills, rules, hooks, agents | | **Cursor** | Full | Plan included + bonus + on-demand $, team OD | MCP, rules, agents | | **Codex (OpenAI)** | Full | Primary 5h, Weekly 7d, per-model $ | MCP, skills | | **Gemini CLI** | Quota | Pro โ†’ Flash โ†’ Flash Lite tier waterfall | Skills, hooks, agents | | **Windsurf** | Config | โ€” | MCP, rules | | **GitHub Copilot** | โ€” | โ€” | Skills | | **VS Code** | โ€” | โ€” | Skills | | **Antigravity** | โ€” | โ€” | Skills | | JetBrains | *Coming soon* | | | | Amp | *Coming soon* | | | | Kiro | *Coming soon* | | | Cursor spend tracking covers the full picture โ€” plan-included, bonus, and on-demand usage โ€” not just a single total. See [Analytics & Tray](docs/analytics.md) for how each metric is derived. --- ## Installation > **macOS 13+ ยท Apple Silicon** ยท Signed with Apple Developer ID and notarized. 1. **Download the latest DMG:** [**AgentHarbor โ€” latest release**](https://github.com/abhiunix/AgentHarbor/releases/latest) - Pick `AgentHarbor__aarch64.dmg`. 2. Open the DMG and drag **AgentHarbor.app** into **Applications**. 3. Launch from Spotlight or `/Applications`. If macOS flags it as "damaged" (rare, caused by quarantine attribute surviving an unusual download path): ```bash xattr -cr /Applications/AgentHarbor.app ``` ### Windows 10/11 ยท x64 1. Download `AgentHarbor__x64-setup.exe` (NSIS, friendlier wizard) or `AgentHarbor__x64_en-US.msi` (MSI, enterprise-deployable) from the [**latest release**](https://github.com/abhiunix/AgentHarbor/releases/latest). 2. Run the installer โ€” it adds a Start menu shortcut (search **AgentHarbor**) and registers under *Settings โ†’ Apps โ†’ Installed apps*. Per-user install, no admin required. > **First-run note:** the Windows installer is currently **unsigned**, so Windows SmartScreen will show *"Windows protected your PC"*. Click **More info โ†’ Run anyway**. A code-signing cert is on the roadmap. On Windows the tray popover anchors above the system tray (clamped to the monitor). The tray icon shows the active provider's logo; hover reveals the current spend (`Provider ยท $X.YZ`) in the tooltip โ€” Windows tray icons can't show inline text the way macOS NSStatusItem can, so the spend lives in the hover tooltip. **Linux** โ€” *Coming soon.* --- ## Tray metric quick reference | Provider | Menu-bar title | Source | |---|---|---| | Claude Code Pro/Max | `XX%` of active **Session (5h)**, fallback to Weekly | `/api/oauth/usage` | | Claude Code Enterprise | `$N` total spend this cycle | `/api/oauth/usage` extra_usage | | Cursor | `$N` total spend = included + bonus + on-demand | Cursor API | | Codex | `XX%` of **Primary (5h)** WHAM window | OpenAI `wham` | | Gemini CLI | `XX%` of highest-priority tier with quota remaining | Cloud Code Assist | The icon swaps to its red variant and appends `!` whenever the active provider is in any non-healthy state. --- ## Documentation | Document | Contents | |---|---| | [Features](docs/features.md) | Visual tour of every major feature | | [Getting Started](docs/getting-started.md) | Install, first launch, connect providers, first deploy | | [Analytics & Tray](docs/analytics.md) | Menu-bar metrics, tray popover, LimitState ladder, per-provider pages | | [Deploying Capabilities & Agents](docs/deploying-capabilities.md) | Deploy wizard, presets, backups, drift detection, removing capabilities | | [Build & Release](docs/build-and-release.md) | Local dev, signed builds, release checklist | | [Troubleshooting](docs/troubleshooting.md) | Common issues and fixes | | [Regression Checklist](docs/regression-checklist.md) | QA checklist before every release | --- ## Privacy AgentHarbor is **local-only**. The only outbound network calls it makes are to each provider's official API endpoints using **your** OAuth tokens. No telemetry, no analytics pings, no data leaves your machine. Local files (Claude project JSONLs, Gemini telemetry) are read with file-share-friendly opens and never copied off-disk. --- ## Tech stack | Layer | Technology | |---|---| | Framework | [](https://tauri.app) | | Backend | [](https://www.rust-lang.org) ยท `reqwest`, `serde`, `keyring`, `chrono` | | Frontend | [](https://react.dev) [](https://www.typescriptlang.org) [](https://vite.dev) | | Styling | [](https://tailwindcss.com) ยท dark theme | | State | [](https://zustand-demo.pmnd.rs) | | Build target | macOS aarch64 + Windows x64 | --- ## Development ```bash npm install npm run tauri dev # hot reload dev npm run test:regression # tsc + vite build + cargo test ``` For signed/notarized release builds, see [`docs/build-and-release.md`](docs/build-and-release.md). ### Project layout ``` agentharbor/ โ”œโ”€โ”€ src/ React frontend โ”‚ โ”œโ”€โ”€ components/ UI (tray, registry, deploy, settings, analytics) โ”‚ โ”œโ”€โ”€ pages/ Route pages โ”‚ โ”œโ”€โ”€ stores/ Zustand state โ”‚ โ”œโ”€โ”€ lib/ Tauri IPC, types, utilities โ”‚ โ””โ”€โ”€ hooks/ Custom hooks โ”œโ”€โ”€ src-tauri/ Rust backend โ”‚ โ”œโ”€โ”€ src/ โ”‚ โ”‚ โ”œโ”€โ”€ analytics/ Per-provider analytics + tray commands โ”‚ โ”‚ โ”œโ”€โ”€ adapters/ Adapter implementations (Claude/Cursor/Windsurf/โ€ฆ) โ”‚ โ”‚ โ”œโ”€โ”€ commands/ Tauri IPC commands โ”‚ โ”‚ โ”œโ”€โ”€ registry/ Capability registry loader & validator โ”‚ โ”‚ โ”œโ”€โ”€ utils/ File I/O, keychain, paths, drift, manifest, backup โ”‚ โ”‚ โ”œโ”€โ”€ tray.rs System tray โ”‚ โ”‚ โ””โ”€โ”€ lib.rs App setup & command registration โ”‚ โ””โ”€โ”€ tauri.conf.json โ”œโ”€โ”€ registry/ Bundled capability/agent definitions โ”œโ”€โ”€ docs/ User & contributor docs โ”œโ”€โ”€ scripts/ bump-build, clear-quarantine, tauri-wrapper โ””โ”€โ”€ public/ Static assets served by Vite ``` --- ## Star History --- ## Contributing Contributions are welcome โ€” bug fixes, new registry capabilities, provider analytics, or docs improvements. See [**CONTRIBUTING.md**](CONTRIBUTING.md) for the full guide: dev setup, code standards, adding registry entries, PR checklist, and commit conventions. --- ## License MIT โ€” see [LICENSE](LICENSE). ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source โ€” we do not rehost the code. - **Author:** [abhiunix](https://github.com/abhiunix) - **Source:** [abhiunix/AgentHarbor](https://github.com/abhiunix/AgentHarbor) - **License:** MIT - **Homepage:** https://agentharbor.openxsecurity.com Install and usage instructions live in the source repository linked above. ## Pricing - **Free** โ€” Free ## Security capabilities Automated source analysis of v0.1.0 โ€” what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source โ€” more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** โ€” security scan: passed โ€” Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-abhiunix-agentharbor - Seller: https://agentstack.voostack.com/s/abhiunix - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack โ€” the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.