Repository navigation
The first public release of fleetwatch: one screen of every Claude Code session you have running, and what each one needs from you.
What's in 1.0
- The board.
fleetwatchopens a terminal dashboard of every session, grouped by what it needs: stuck on a permission prompt, waiting on a question, an item due today or overdue, or quiet. It reads Claude Code's own records, plus a small status file each session can write withfleetwatch write-status. Enter jumps to a session's iTerm2 tab, and Resume reopens one that has ended. - Notifications.
fleetwatch notifyis an opt-in background process that raises a desktop notification when a session gets stuck, asks a new question or has an item come due. On macOS a click takes you to that session's tab. - Session memory and search.
fleetwatch indexkeeps a searchable, tagged index of each session's own transcript and its reference folders, so a session can recall what compaction dropped. A privacy scrubber runs before anything is written, and trust groups decide at search time which session may read which index. - Watches. A session can hand fleetwatch standing checks on GitHub repositories, such as failed checks, stale pull requests, activity from outside contributors and security advisories, so they stay watched while the session is closed.
- Schedules. The index refresh, watches and notifications each install as a launchd agent on macOS or a systemd user unit on Linux with one
schedule installcommand.
Install
fleetwatch needs Python 3.11 or newer.
pip install 'fleetwatch @ git+https://github.com/daniel-pittman/fleetwatch@v1.0.0' # the board
pip install 'fleetwatch[search,memory] @ git+https://github.com/daniel-pittman/fleetwatch@v1.0.0' # plus session memory
The search extra pulls in PyTorch and downloads about 1.1 GB of models on first use. The README lists the optional outside programs (iTerm2, gh, terminal-notifier and others) and the feature each one enables.
Tested on Python 3.11 to 3.14, on macOS and Linux.
fleetwatch is an independent project, not affiliated with or endorsed by Anthropic. MIT licensed.