AgentHarbor

abhiunix14starsClaim this server

🚢 One native app for all your AI coding agents - live rate limits, session usage, deep analysis of your & monthly spend for Claude Code, Cursor, Codex, Gemini etc plus one-click MCP/rules/skills/sub-

Devops

Install Run on PlugMCPClaim this server

GitHub Website

Run on PlugMCP

1# AgentHarbor

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-26

Stars: 14
Tools: —
Uptime: —

Overview

About AgentHarbor

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install AgentHarbor?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does AgentHarbor need an API key?

No required environment variable is listed on this record.

What transport does AgentHarbor use?

AgentHarbor runs locally over stdio.

When was AgentHarbor last checked?

Last checked 2026-10-26. 🚢 One native app for all your AI coding agents - live rate limits, session usage, deep analysis of your & monthly spend for Claude Code, Cursor, Codex, Gemini etc plus one-click MCP/rules/skills/sub-agent deploy.

From the publisher

Documentation

English | Español

AgentHarbor

One tray app to manage all your AI coding agents.

For developers running Claude Code, Cursor, Codex, Gemini CLI, Kimi, DeepSeek, or Windsurf: track usage and spend, manage configurations, deploy capabilities, and keep every tool in sync — all from one native app.

Website · Download · Getting Started · Features · 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.

Screenshots

Live limits, active agents, and Today / Week / All-time spend for every provider, right in your menu bar.

Deep analytics behind every provider

Session and weekly limits with severity coloring, an active-window marker, and reset countdowns.

See how it compares to ccusage and CodexBar →

Why AgentHarbor?

Tools like ccusage and 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 ~60 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 and reuse them across projects.
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
Kimi (Moonshot)	Full (local sessions)	Subscription 5h/weekly or Moonshot balance	—
DeepSeek	Full (local sessions)	Account balance	—
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 for how each metric is derived.

Installation

macOS 13+ · Apple Silicon · Signed with Apple Developer ID and notarized.

Download the latest DMG: AgentHarbor — latest release
- Pick AgentHarbor_<version>_aarch64.dmg.
Open the DMG and drag AgentHarbor.app into Applications.
Launch from Spotlight or /Applications.

If macOS flags it as "damaged" (rare, caused by quarantine attribute surviving an unusual download path):

xattr -cr /Applications/AgentHarbor.app

Windows 10/11 · x64

Download AgentHarbor_<version>_x64-setup.exe (NSIS, friendlier wizard) or AgentHarbor_<version>_x64_en-US.msi (MSI, enterprise-deployable) from the latest release.
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	Visual tour of every major feature
Getting Started	Install, first launch, connect providers, first deploy
Analytics & Tray	Menu-bar metrics, tray popover, LimitState ladder, per-provider pages
Deploying Capabilities & Agents	Deploy wizard, presets, backups, drift detection, removing capabilities
Build & Release	Local dev, signed builds, release checklist
Troubleshooting	Common issues and fixes
Regression Checklist	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
Backend	· `reqwest`, `serde`, `keyring`, `chrono`
Frontend
Styling	· dark theme
State
Build target	macOS aarch64 + Windows x64

Development

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.

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 for the full guide: dev setup, code standards, adding registry entries, PR checklist, and commit conventions.

License

MIT — see LICENSE.