Skip to content

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

  1. Install (PyPI recommended)
  2. Quickstart — init, doctor, status
  3. 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.