Skip to content

fleetwatch 1.0.0

Latest

Choose a tag to compare

@daniel-pittman daniel-pittman released this 15 Nov 06:15
· 8 commits to develop since this release

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. fleetwatch opens 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 with fleetwatch write-status. Enter jumps to a session's iTerm2 tab, and Resume reopens one that has ended.
  • Notifications. fleetwatch notify is 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 index keeps 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 install command.

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.