CLI · source included
agent-health: stop losing afternoons to rotted Cursor chats
Long-running Cursor agent chats fail you in two quiet ways: context rot — quality collapses as the window fills — and silent token spend, where long chats auto-compact and keep re-sending tokens forever.
agent-health is a small, strictly read-only CLI that catches both. It reads Cursor's local state, tiers your chats (watch / handoff / archive), flags runaway volume, writes a dated Markdown report, and on macOS schedules a daily nudge before quality degrades. When a chat is too far gone, one command writes a handoff doc and opens a fresh, primed Cursor window.
You get the full, commented Rust source — audit every line of what reads your editor's data. It opens Cursor's database with SQLITE_OPEN_READ_ONLY, and nothing leaves your machine unless you opt in.
Personal source-available license. Build with one cargo install. 7-day refund policy.
What it does
- Daily health report — watch / handoff / archive tiers plus runaway-volume flags
- Roll-off with handoffs — handoff doc and a fresh primed Cursor window in one command
- Doctor self-check — PASS/WARN/FAIL per dependency
- Strictly read-only against Cursor's database — auditable in the source you get
- Private by default — nothing leaves the machine unless you opt in
- Full source included — no black box reading your editor data
FAQ
- What am I actually buying?
- The complete Rust source code, build instructions, and all future updates. Personal source-available license: use it anywhere you work, modify it for yourself, don't redistribute it.
- Why source instead of a binary?
- A tool that reads your editor's local database should be auditable. You can read every line before you run it. A prebuilt signed binary is planned as a convenience under the same license.
- Is it safe to run against my Cursor install?
- Yes — strictly read-only against Cursor's state database. The only files it creates are its own reports and handoff docs.
- Does my chat data go anywhere?
- No. Everything is local. The one exception is the opt-in AI summary feature, which uses the endpoint and key you configure. It's off by default.
- What platforms does it support?
- macOS is tested — scheduling and dialogs use launchd and AppleScript. The core commands are OS-agnostic in principle.
- Do I need Rust installed?
- Yes for now:
cargo install --path .from the source you download. A prebuilt binary is planned. - Refunds?
- 7 days, reviewed individually. A refund ends the license, including updates.