CursorFleet¶
A local task-centric observer for Cursor agent teams: see who did what, where work happened, and what was declared— from passive hooks and read-only git, without sending anything anywhere.
Unofficial. CursorFleet is not affiliated with or endorsed by Anysphere or Cursor. "Cursor" is a trademark of its respective owner. The name "CursorFleet" is a working name.
Status¶
Pre-alpha. 0.1.0 and
0.1.1 are on
PyPI; GitHub tags v0.1.0 and v0.1.1
(no non-draft GitHub Releases page yet). See
Installation (pipx / uv tool install cursorfleet).
- v0.1 is Observe only: no enforcement, no forced approvals, and no cloud-agent visibility (local Cursor sessions only). It is not a security boundary: a malicious or prompt-injected agent can bypass or forge what it shows.
- Product hooks were exercised on Linux Cursor IDE 3.22.7 (maintainer smoke): hook telemetry, subagent lifecycle, and work artifacts were observed. Details: live validation index (in-repo).
- Q1 and Q2 (subagent identity on tool hooks; custom subagent names) remain OPEN. Parallel classification is BLOCKED/OPEN on the exercised Linux surface.
- Active Run is the default TUI screen (a); session archive is o; runs list is u. See TUI current status.
- CI runs on GitHub Actions; documentation is published via GitHub Pages.
- Linux is the primary tested platform; macOS and Windows are CI-tested only.
- Local only: no network calls, no telemetry, no accounts. CursorFleet does not store prompts, model thinking, responses, file contents, command output, environment variables, emails, or transcript paths.
Get started¶
- Install (PyPI recommended)
- Quickstart —
init,doctor,status - CLI, privacy, and known limitations
Git is required for init. There is no --allow-non-git flag.
What you get in the checkout¶
| Area | What exists today |
|---|---|
| Kit | cursorfleet init --cursor, uninstall, doctor, validate |
| Observer | Fail-open cursorfleet-hook, local spool and projection, status --json |
| Dashboard | cursorfleet tui — observe-only; Active Run default (explicit run attach) |
| Scope | One Git repository; runtime state under that repo's Git common directory |
License¶
MIT. Source: github.com/M9nx/cursorfleet.