fleetlisted
Install: claude install-skill thettwe/nyann
# fleet
> **Plugin root:** `<plugin_root>/skills/fleet/SKILL.md` — scripts live at
> `<plugin_root>/bin/fleet.sh` (registry CRUD) and
> `<plugin_root>/bin/fleet-doctor.sh` (bulk audit + dashboard).
Read-only across the board: the registry file is the only thing this skill
ever writes, and every registry mutation previews first. The registry lives
at `~/.claude/nyann/fleet.json` and holds LOCAL working-copy paths — it is
deliberately distinct from the sentinel watch-list (GitHub slugs for remote
CI polling); an entry's optional `repo` slug is the join key between the two.
## 1. Registry management
All CRUD goes through `bin/fleet.sh` (`--fleet-file` only in tests):
| User intent | Invocation |
|---|---|
| "add this repo" | `bin/fleet.sh --add <path> [--name n] [--repo o/r] [--profile p] [--tag t]` |
| "add and watch its PRs too" | append `--watch` (mirrors the slug into the sentinel watch-list; resolves the slug from the origin remote when `--repo` is omitted) |
| "remove X" | `bin/fleet.sh --remove <name-or-path>` |
| "list my fleet" | `bin/fleet.sh --list` (JSON — render it as a table) |
| "scan ~/Works for repos" | `bin/fleet.sh --scan <dir> [--depth n]` |
| "clean out dead entries" | `bin/fleet.sh --prune` |
| "what org repos am I missing?" | `bin/fleet.sh --suggest-org <org>` (gh best-effort, advisory only — nyann never clones) |
**`--scan` and `--prune` are preview-first**: the bare call prints the
candidate list and writes NOTHING. Show the list, confirm with
AskU