{"id":47609687,"url":"https://github.com/hoveychen/claw-fleet","last_synced_at":"2026-05-25T10:01:39.553Z","repository":{"id":345067304,"uuid":"1184063291","full_name":"hoveychen/claw-fleet","owner":"hoveychen","description":"Mission control for your Claude Code agents.","archived":false,"fork":false,"pushed_at":"2026-04-04T16:09:29.000Z","size":28563,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-04T19:11:21.502Z","etag":null,"topics":["agents","claude-code","monitoring"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hoveychen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":"CLA.md"}},"created_at":"2026-03-17T08:04:51.000Z","updated_at":"2026-04-04T16:08:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"fc6c983c-fc2a-4af9-8b28-7bbccec92f70","html_url":"https://github.com/hoveychen/claw-fleet","commit_stats":null,"previous_names":["hoveychen/claude-fleet","hoveychen/claw-fleet"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/hoveychen/claw-fleet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoveychen%2Fclaw-fleet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoveychen%2Fclaw-fleet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoveychen%2Fclaw-fleet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoveychen%2Fclaw-fleet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hoveychen","download_url":"https://codeload.github.com/hoveychen/claw-fleet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoveychen%2Fclaw-fleet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31643431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-10T07:40:12.752Z","status":"ssl_error","status_checked_at":"2026-04-10T07:40:11.664Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","claude-code","monitoring"],"created_at":"2026-04-01T19:56:53.730Z","updated_at":"2026-05-25T10:01:39.547Z","avatar_url":"https://github.com/hoveychen.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"docs/hero.png\" width=\"640\" alt=\"Claw Fleet — Mission control for your Claude Code agents\" /\u003e\n\n# Claw Fleet\n\n**Mission control for your AI coding agents.**\nMonitor every session, track token throughput **and live USD spend**, get AI-generated daily summaries and lessons learned — all from one place.\nSupports **Claude Code**, **Cursor**, **OpenClaw**, and **Codex**.\n\n[![Release](https://img.shields.io/github/v/release/hoveychen/claw-fleet?style=flat-square\u0026logo=github\u0026color=d97757)](https://github.com/hoveychen/claw-fleet/releases/latest)\n[![License](https://img.shields.io/github/license/hoveychen/claw-fleet?style=flat-square\u0026color=4a9eff)](LICENSE)\n[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux%20%7C%20Android-lightgrey?style=flat-square)](https://github.com/hoveychen/claw-fleet/releases/latest)\n[![Built with Tauri](https://img.shields.io/badge/built%20with-Tauri%202-24C8DB?style=flat-square\u0026logo=tauri)](https://tauri.app)\n[![React](https://img.shields.io/badge/React-19-61dafb?style=flat-square\u0026logo=react)](https://react.dev)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178c6?style=flat-square\u0026logo=typescript)](https://www.typescriptlang.org)\n\n\u003c/div\u003e\n\n---\n\n\n## What is Claw Fleet?\n\nWhen you run Claude Code across multiple projects simultaneously — or lean on its multi-agent delegation feature — it's easy to lose track of what each agent is doing, how fast it's working, or whether it's stuck waiting for your input. At the end of the day, you want to know: what actually got done? And what mistakes should your agents avoid next time?\n\n**Claw Fleet** solves both. It watches session files in real time and presents everything in a clean dashboard. At the end of each day, it generates **AI-powered summaries** of what your agents accomplished and extracts **lessons learned** from their mistakes — turning raw session logs into actionable standup reports and persistent knowledge. No server required, no API key needed beyond what Claude Code already uses.\n\n\u003e **Meet Captain Claw** 🦀 — our mascot. A battle-hardened crab commander who keeps every agent in formation.\n\n---\n\n## Supported Agents\n\nClaw Fleet can monitor sessions from multiple AI coding agents:\n\n| | Agent | Status |\n|---|---|---|\n| \u003cpicture\u003e\u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"claw-fleet-desktop/app/assets/icons/claude.svg\"\u003e\u003csource media=\"(prefers-color-scheme: light)\" srcset=\"claw-fleet-desktop/app/assets/icons/claude-dark.svg\"\u003e\u003cimg src=\"claw-fleet-desktop/app/assets/icons/claude-dark.svg\" width=\"24\" height=\"24\"\u003e\u003c/picture\u003e | **Claude Code** | Fully supported — enabled by default |\n| \u003cpicture\u003e\u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"claw-fleet-desktop/app/assets/icons/cursor.svg\"\u003e\u003csource media=\"(prefers-color-scheme: light)\" srcset=\"claw-fleet-desktop/app/assets/icons/cursor-dark.svg\"\u003e\u003cimg src=\"claw-fleet-desktop/app/assets/icons/cursor-dark.svg\" width=\"24\" height=\"24\"\u003e\u003c/picture\u003e | **Cursor** | Supported — opt-in via Settings |\n| \u003cpicture\u003e\u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"claw-fleet-desktop/app/assets/icons/openclaw.svg\"\u003e\u003csource media=\"(prefers-color-scheme: light)\" srcset=\"claw-fleet-desktop/app/assets/icons/openclaw-dark.svg\"\u003e\u003cimg src=\"claw-fleet-desktop/app/assets/icons/openclaw-dark.svg\" width=\"24\" height=\"24\"\u003e\u003c/picture\u003e | **OpenClaw** | Fully supported |\n| \u003cpicture\u003e\u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"claw-fleet-desktop/app/assets/icons/codex.svg\"\u003e\u003csource media=\"(prefers-color-scheme: light)\" srcset=\"claw-fleet-desktop/app/assets/icons/codex-dark.svg\"\u003e\u003cimg src=\"claw-fleet-desktop/app/assets/icons/codex-dark.svg\" width=\"24\" height=\"24\"\u003e\u003c/picture\u003e | **Codex** | Fully supported |\n\n\u003e Toggle agent sources on or off in the app's Settings panel. Claw Fleet auto-detects which tools are installed on your system.\n\n---\n\n## Why Claw Fleet?\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"docs/features_grid.png\" width=\"720\" alt=\"Claw Fleet — Key Features\" /\u003e\n\u003c/div\u003e\n\n---\n\n## Screenshots\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\u003cstrong\u003eGallery View\u003c/strong\u003e — multi-agent dashboard\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\u003cstrong\u003eSession Detail\u003c/strong\u003e — multi-subagent hierarchy\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cimg src=\"docs/screenshots/01_gallery.png\" alt=\"Gallery View\" /\u003e\u003c/td\u003e\n\u003ctd\u003e\u003cimg src=\"docs/screenshots/02_session_detail.png\" alt=\"Session Detail\" /\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cstrong\u003eSecurity Audit\u003c/strong\u003e — tool-use risk scanning\u003c/td\u003e\n\u003ctd\u003e\u003cstrong\u003eCaptain Claw\u003c/strong\u003e — your AI fleet assistant\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cimg src=\"docs/screenshots/03_audit.png\" alt=\"Audit View\" /\u003e\u003c/td\u003e\n\u003ctd\u003e\u003cimg src=\"docs/screenshots/04_mascot.png\" alt=\"Mascot Assistant\" /\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cstrong\u003eMemory\u003c/strong\u003e — cross-session knowledge\u003c/td\u003e\n\u003ctd\u003e\u003cstrong\u003eNotifications\u003c/strong\u003e — waiting \u0026 audit alerts\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cimg src=\"docs/screenshots/05_memory.png\" alt=\"Memory Panel\" /\u003e\u003c/td\u003e\n\u003ctd\u003e\u003cimg src=\"docs/screenshots/06_notifications.png\" alt=\"Notifications\" /\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cstrong\u003eInsights Timeline\u003c/strong\u003e — AI summaries \u0026 lessons feed\u003c/td\u003e\n\u003ctd\u003e\u003cstrong\u003eDaily Report\u003c/strong\u003e — metrics, charts \u0026 AI summary\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003e\u003cimg src=\"docs/screenshots/07_report.png\" alt=\"Insights Timeline\" /\u003e\u003c/td\u003e\n\u003ctd\u003e\u003cimg src=\"docs/screenshots/08_daily_report.png\" alt=\"Daily Report\" /\u003e\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Features\n\n**AI daily summaries — the standup update you never write.** Each day's sessions are distilled into a narrative: what your agents built, which tasks completed, where they got stuck. Token usage, activity heatmap, tool call breakdown — all generated automatically. Copy as Markdown and paste straight into Slack or your standup thread.\n\n**Lessons learned — AI mistakes become team knowledge.** Claw Fleet scans session logs for missteps — wrong assumptions, failed approaches, repeated retries — and extracts concise lessons. One click adds them to your `CLAUDE.md`, so agents never repeat the same mistakes. This is how your fleet gets smarter over time.\n\n**8 live statuses, not just \"running\".** Your agents are thinking, executing, streaming, delegating, or waiting for you — Claw Fleet tells you which, with parent-child hierarchies grouped automatically. Stuck agent? Kill it from the dashboard.\n\n**Cost tracker that reflects what you actually pay.** Token speed tells you how fast an agent is streaming; it doesn't tell you what it's costing you. Claw Fleet shows live **USD spend per session** on every card, plus a fleet-wide **`$/min` rate chart** with a rolling 5-minute window total — fully accounting for cached reads, cache writes, input vs. output pricing, and per-model rates. For a main agent that delegates, you see both its own cost and the aggregate including every subagent it spawned. Catch a runaway loop before it drains your account, and finally know which project is burning your budget.\n\n**Security audit built in.** Every Bash command your agents run gets scanned and classified by risk. `sudo`, `git push --force`, `rm -rf` — you'll catch the dangerous ones before they become incidents.\n\n**Your agents' memory, finally visible.** `CLAUDE.md` files and memory entries scattered across dozens of projects, indexed in one place. Browse, diff, promote to global scope.\n\n**Monitor from your phone.** The companion Android app connects to your desktop via a secure tunnel — scan a QR code and you're in. See live agent statuses, token speeds, and conversation history from anywhere. Stop a runaway agent from the couch.\n\n**Remote agents, local dashboard.** SSH into your cloud box and monitor remote agents alongside local ones. Auto-bootstraps itself on the remote side. No port forwarding, no VPN.\n\n**Agents that manage agents.** Install the Fleet Skill and your AI coding agent can check on — and stop — other running agents on its own.\n\n**A CLI for everything.** `fleet agents`, `fleet stop`, `fleet audit`, `fleet search` — all with `--json`. Stay in the terminal if that's your thing.\n\n**Zero config.** Download. Open. It reads local session files directly — no server, no API key. macOS, Windows, Linux.\n\n---\n\n## Installation\n\nDownload the latest pre-built binary for your platform from the [Releases page](https://github.com/hoveychen/claw-fleet/releases/latest):\n\n| | Platform | Architecture | Download |\n|---|---|---|---|\n| \u003cimg src=\"docs/icon-apple.svg\" width=\"24\"\u003e | macOS | Universal (Intel + Apple Silicon) | [claw-fleet-macos.pkg](https://github.com/hoveychen/claw-fleet/releases/latest/download/claw-fleet-macos.pkg) |\n| \u003cimg src=\"docs/icon-windows.svg\" width=\"24\"\u003e | Windows | x64 / ARM64 | [claw-fleet-windows-x64-setup.exe](https://github.com/hoveychen/claw-fleet/releases/latest/download/claw-fleet-windows-x64-setup.exe) |\n| \u003cimg src=\"docs/icon-linux.svg\" width=\"24\"\u003e | Linux | x86\\_64 | [claw-fleet-linux-x64.deb](https://github.com/hoveychen/claw-fleet/releases/latest/download/claw-fleet-linux-x64.deb) · [claw-fleet-linux-x64.AppImage](https://github.com/hoveychen/claw-fleet/releases/latest/download/claw-fleet-linux-x64.AppImage) |\n| \u003cimg src=\"docs/icon-android.svg\" width=\"24\"\u003e | Android | ARM64 / x86_64 | [claw-fleet-mobile.apk](https://github.com/hoveychen/claw-fleet/releases/latest/download/claw-fleet-mobile.apk) |\n\n\u003e **Mobile app**: The Android companion app is released separately — look for the latest `mobile-v*` release on the [Releases page](https://github.com/hoveychen/claw-fleet/releases). Scan the QR code shown in Claw Fleet Desktop to connect.\n\n### Prerequisites\n\nClaw Fleet reads session data written by **Claude Code** (`claude` CLI). You need Claude Code installed and have run at least one session before anything shows up.\n\n---\n\n## Build from Source\n\n### Requirements\n\n- [Rust](https://rustup.rs) (stable, 1.77+)\n- [Node.js](https://nodejs.org) 20+\n- [Tauri CLI v2](https://tauri.app/start/prerequisites/)\n\n### Steps\n\n```bash\ngit clone https://github.com/hoveychen/claw-fleet.git\ncd claw-fleet\n\npnpm install\n\n# Development (hot-reload)\npnpm tauri dev\n\n# Production build\npnpm tauri build\n```\n\nThe output binary and installer are placed under `target/release/bundle/`.\n\n---\n\n## How It Works\n\nClaw Fleet reads directly from Claude Code's local data directory (`~/.claude/`) — no network calls, no background services, nothing you need to configure.\n\n```\n~/.claude/\n├── ide/\n│   └── *.lock          ← active IDE process info (pid, workspace, auth token)\n└── projects/\n    └── \u003cworkspace\u003e/\n        └── *.jsonl     ← append-only conversation history (one JSON object per line)\n```\n\n1. **Startup** — scans all `.lock` files to find live IDE processes\n2. **File watcher** — uses OS-native events (FSEvents on macOS, inotify on Linux) to detect new JSONL lines the moment Claude writes them\n3. **Status inference** — derives session state from the last assistant message's `stop_reason` field and file modification time\n4. **Token speed** — aggregates `usage.output_tokens` across the most recent messages and divides by elapsed time\n\nEverything runs in-process inside the Tauri Rust backend. The React frontend communicates via Tauri's IPC bridge.\n\n---\n\n## Task-as-Unit Mode\n\nBeyond the legacy \"spawn a session, watch it\" launcher, Fleet supports a higher-level **task** abstraction where one user-stated goal becomes a DAG of small P-items orchestrated by a long-running **master** agent (Sonnet 4.6) that dispatches per-P-item **worker** subprocesses.\n\n**Lifecycle:**\n1. **Inbox** — click `+ New task` in the sidebar. Drop files, paste screenshots, or type a description.\n2. **Plan** — the `atomic-plan-tasks` skill drafts a DAG of P-items (with `touches` / `depends_on` / `resources` / `acceptance` / `human_gate`).\n3. **Start** — Fleet creates a `fleet/\u003ctitle-slug\u003e` git branch and spawns the master session. The master calls `fleet task get-dispatchable` and dispatches workers respecting resource locks.\n4. **Per-item worktree** — every dispatched P-item runs inside its own isolated git worktree at `~/.fleet/worktrees/\u003ctask\u003e/\u003cp\u003e/` on branch `fleet/\u003ctask\u003e/\u003cp\u003e`. Workers can `cargo build` / `cargo test` / `pnpm build` freely without trampling parallel siblings.\n5. **Acceptance audit + fast-forward merge** — workers stop on completion; the master verifies `acceptance`, then `mark-done` fast-forward-merges the P-item's worktree branch back into the task branch and reaps the worktree. `human_gate=true` P-items trigger an `AskUserQuestion` via the Decision Panel before mark-done.\n6. **Done** — when every P-item is terminal and the master exits, the task flips to Done and `completed_at` is stamped.\n\n**What can you do:**\n- Surface every active task in the sidebar (grouped by project) with progress chips\n- See macro metrics per project (active tasks, done this week, avg duration, longest running)\n- Flip `manual_review_all` on a project to force every P-item through user approval\n- Pause / resume / clear a task — master + workers respond to SIGSTOP / SIGCONT / SIGTERM\n\n**Current limits:**\n- Fast-forward-only merges; diverged worker / task branches surface as a Conflict and pause the P-item. LLM-driven conflict mediation is the next milestone (see [`design/task-as-unit-redesign.md`](design/task-as-unit-redesign.md) §V2).\n- The `atomic-plan-tasks` skill produces the initial DAG but doesn't iteratively refine it\n- No auto-generated architecture overview — drop one at `~/.fleet/projects/\u003cid\u003e/architecture.md` to get Layer-1 context injection\n- E2E mock harness in `e2e/task-as-unit.spec.ts` exercises the surface; real-agent dogfood lands in the dogfood PR per `design/task-as-unit-redesign.md`\n\nSee [`design/task-as-unit-redesign.md`](design/task-as-unit-redesign.md) for the full architecture spec.\n\n---\n\n## Mobile Companion App\n\nClaw Fleet ships with an Android companion app that lets you monitor your agents from your phone.\n\n**Features:**\n- Live agent statuses with token speed and context usage\n- Conversation history with thinking blocks, tool calls, and code highlights\n- Security audit events\n- Stop agents remotely\n- Dark / light theme, follows system setting\n\n**How to connect:**\n1. Open Claw Fleet Desktop and click the phone icon in the sidebar (or go to Settings → Mobile)\n2. Click \"Enable Mobile Access\" — this starts a secure Cloudflare tunnel\n3. Scan the QR code with the mobile app\n\nThe mobile app is a read-only client (except for stop commands). All data flows through the desktop app's embedded HTTP server via the tunnel — no direct access to your filesystem.\n\n**Building from source:** See [`claw-fleet-mobile/README.md`](claw-fleet-mobile/README.md) for build instructions.\n\n---\n\n## Contributing\n\nPull requests are welcome! A few pointers:\n\n- **Backend** is Rust in `claw-fleet-core/src/` — `session.rs` owns session parsing, `watcher.rs` owns the file-system loop\n- **Frontend** is React + TypeScript in `src/` — components use CSS Modules, state is managed with Zustand\n- **i18n** — locale files live in `src/locales/`; copy `en.json`, translate, register in `src/i18n.ts`\n\nPlease open an issue before starting large changes so we can coordinate.\n\nBy submitting a pull request, you agree to the [Contributor License Agreement (CLA)](CLA.md). The CLA grants the project owner the right to relicense contributions under other licenses (including commercial ones) while keeping the public release under AGPL-3.0.\n\n---\n\n## License\n\nThis project is licensed under the [GNU Affero General Public License v3.0](LICENSE) (AGPL-3.0-only).\n\nCopyright © 2025 hoveychen\n\nUnder AGPL-3.0, if you run a modified version of this software to provide a service over a network, you must make the complete source code of your modified version available to users of that service.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoveychen%2Fclaw-fleet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhoveychen%2Fclaw-fleet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoveychen%2Fclaw-fleet/lists"}