Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,8 @@ Organize related tasks into named groups across working directories.

Launch `claude`, `codex`, `grok`, or `omp` from the Agent page (`n`, then `Tab`). Rerun the task or reload a saved session to resume the conversation.

![`fleetcom` Agent page](docs/img/agent.png)

## Operational model

Managing several long-lived commands across terminal panes is pesky, especially when you need to reconnect later. With `fleetcom`:
Expand Down
22 changes: 18 additions & 4 deletions docs/img/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,9 @@ Display it with `cat` to reproduce the live layout in a terminal.
| `quickpeek.ansi` | grouped by state, peek open over a finished run |
| `groups.ansi` | grouped by custom group: five directories in one section, and one directory represented in two sections |
| `controls.ansi` | the `?` overlay over the dir-grouped dashboard |
| `agent.ansi` | the spawn prompt's Agent page (`n`, then `Tab`) over the dir-grouped dashboard, every supported agent installed |

The same 21 tasks are rendered in all four frames. Capture `attach.png` from
The same 21 tasks are rendered in all five frames. Capture `attach.png` from
a live session while attached.

The fixture is `write_readme_screenshot_fixtures` in `src/app_readme_tests.rs`. Edit the
Expand All @@ -30,6 +31,7 @@ clear; cat docs/img/home.ansi; read -rsk 1; printf '\033[?25h'
clear; cat docs/img/quickpeek.ansi; read -rsk 1; printf '\033[?25h'
clear; cat docs/img/groups.ansi; read -rsk 1; printf '\033[?25h'
clear; cat docs/img/controls.ansi; read -rsk 1; printf '\033[?25h'
clear; cat docs/img/agent.ansi; read -rsk 1; printf '\033[?25h'
```

`read` pauses until a keypress, leaving the frame on screen without further output.
Expand All @@ -38,10 +40,22 @@ restores the hidden cursor.
The flags are zsh's; use `read -rs -n1` in bash, or `read -r` in either shell
to wait for Enter.

The cursor is placed on the terminal's last row, outside centered overlays.
Without this placement after `render_peek`, the cursor would be left inside
the peek box during `read`.
The cursor is placed on the terminal's last row, outside centered overlays,
then hidden. Without this placement after `render_peek`, the cursor would be
left inside the peek box during `read`; without hiding it, the Agent page's
filter caret would leave a visible cursor cell in the parked position.

Use a terminal at least 107×30, the frame size. Run `clear` first: only the
frame's rows are painted, leaving stale scrollback visible beneath them in a
taller window.

## Compressing

A window capture is a 32-bit RGBA PNG of about 550 KB with color-profile and
EXIF chunks. Quantize it to a 256-color palette and strip the metadata:

```sh
pngquant --force --ext .png --strip 256 docs/img/<frame>.png
```

The result is about 200 KB and matches the committed files' format.
1 change: 1 addition & 0 deletions docs/img/agent.ansi
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
]0;fleetcom[?2026h[?25l fleetcom 12 running · 2 idle · 7 done by state · dir · custom · 12/21   ~/Documents/Code/Rust/fleetcom ◆ ✻ Dashboard Refine Scope small fixes for dashboard and CLI 2m◆ ● Summary Refine Fable 5.1 (high) · Inferring… · thinking with high effort 5m ● Grok Language Grok 4.7 (xhigh) · Responding… 12m ✻ Codex Language GPT-6.1-Sol high · fleetcom · feat/cs/interface-fixes · 387K used · 9.5… 18m ✻ Codex Review GPT-6.1-Sol high · fleetcom · feat/cs/interface-fixes · 221K used · 4.4… 24m ✓ cargo test test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered … 12s ✗ cargo clippy error: could not compile `fleetcom` (lib test) due to 1 previous error 3m ~  ✻ claude agents 2 awaiting input · claude agents 1h⚑ ✻ Zellij Desktop ¦ Utility 2h ∙ python >>> 41m ✓ brew update && brew upgra… Already up-to-date. 13m ~/Documents/Code/Apple/turret  ✻ Game Infra Review Turret Game Codebase Organization and Ex… - grok 8m ✻ Missile Nerf Tuning missile damage falloff 33m ✻ EMP Nerf EMP arc balance pass 35m ~/Documents/Code/Rust/crabapple  ✓ cargo test all doctests ran in 0.39s; merged doctests compilation took 0.38s 17m ~/Documents/Code/Rust/crabstep  ✓ cargo test all doctests ran in 0.83s; merged doctests compilation took 0.81s 21m ~/Documents/Code/Rust/imessage-exporter  ✻ claude Opus 5.5 (high) · Review GitHub issue 780 6m ✓ cargo test all doctests ran in 1.99s; merged doctests compilation took 1.95s 19m ~/Documents/Code/Rust/Logria  ✻ cargo watch -x test [Running 'cargo test'] test result: ok. 223 passed; 0 failed 45s ❯ n run · @ dir · / find · s sort  enter run · tab agents (4) · esc [?25l ❯ ~/Documents/Code/Apple/turret ▸ agent:  ▸ claude  codex  grok  omp  ↑↓ pick · enter launch · tab command · esc [?25h[?2026l[?25l
Binary file added docs/img/agent.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/img/controls.ansi
Original file line number Diff line number Diff line change
@@ -1 +1 @@
]0;fleetcom[?2026h[?25l fleetcom 12 running · 2 idle · 7 done by state · dir · custom · 4/21   ~/Documents/Code/Rust/fleetcom ◆ ✻ Dashboard Refine Scope small fixes for dashboard and CLI 2m◆ ✻ Summary Refine Inferring… · thinking with high effort 5m ✻ Grok Language Grok 4.5 (xhigh) · Responding… 12m ✻ Codex Language gpt-5.6-sol high · fleetcom · feat/cs/interface-fixes · 387K used · 9.5… 18m ✻ Codex Review gpt-5.6-sol high · fleetcom · feat/cs/interface-fixes · 221K used · 4.4… 24m ✓ cargo test test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered … 12s ✗ cargo clippy error: could not compile `fleetcom` (lib test) due to 1 previous error 3m ~  ✻ claude agents 2 awaiting input · claude agents 1h⚑ ✻ Zellij Desktop ¦ Utility 2h ∙ python >>> 41m ✓ brew update && brew upgra… Already up-to-date. 13m ~/Documents/Code/Apple/turret  ✻ Game Infra Review Turret Game Codebase Organization and Ex… - grok 8m ✻ Missile Nerf Tuning missile damage falloff 33m ✻ EMP Nerf EMP arc balance pass 35m ~/Documents/Code/Rust/crabapple  ✓ cargo test all doctests ran in 0.39s; merged doctests compilation took 0.38s 17m ~/Documents/Code/Rust/crabstep  ✓ cargo test all doctests ran in 0.83s; merged doctests compilation took 0.81s 21m ~/Documents/Code/Rust/imessage-exporter  ✻ claude Review GitHub issue 780 6m ✓ cargo test all doctests ran in 1.99s; merged doctests compilation took 1.95s 19m ~/Documents/Code/Rust/Logria  ✻ cargo watch -x test [Running 'cargo test'] test result: ok. 223 passed; 0 failed 45s ❯ n run · @ dir · / find · s sort  ↑↓ select · enter attach · space peek · ? controls · Ctrl-] flagship [?25l┌─ controls ──────────────────────────────────────────────┐│ Navigate ││ ↑↓ / kj move selection / find a task ││ Tab ⇧Tab jump section M next tagged ││ Act ││ enter attach r rerun finished ││ space peek X kill or remove ││ Organize ││ m tag in use R rename ││ ] flagship s cycle grouping ││ g assign group ││ Create ││ n run here @ run in a dir ││ Session ││ w save session o load session ││ Leave ││ q detach Q quit and kill ││ Attached ││ Ctrl-\ background Ctrl-] flagship / back │└─────────────────────────────────────────────────────────┘ ? esc close [?2026l
]0;fleetcom[?2026h[?25l fleetcom 12 running · 2 idle · 7 done by state · dir · custom · 4/21   ~/Documents/Code/Rust/fleetcom ◆ ✻ Dashboard Refine Scope small fixes for dashboard and CLI 2m◆ ● Summary Refine Fable 5.1 (high) · Inferring… · thinking with high effort 5m ● Grok Language Grok 4.7 (xhigh) · Responding… 12m ✻ Codex Language GPT-6.1-Sol high · fleetcom · feat/cs/interface-fixes · 387K used · 9.5… 18m ✻ Codex Review GPT-6.1-Sol high · fleetcom · feat/cs/interface-fixes · 221K used · 4.4… 24m ✓ cargo test test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered … 12s ✗ cargo clippy error: could not compile `fleetcom` (lib test) due to 1 previous error 3m ~  ✻ claude agents 2 awaiting input · claude agents 1h⚑ ✻ Zellij Desktop ¦ Utility 2h ∙ python >>> 41m ✓ brew update && brew upgra… Already up-to-date. 13m ~/Documents/Code/Apple/turret  ✻ Game Infra Review Turret Game Codebase Organization and Ex… - grok 8m ✻ Missile Nerf Tuning missile damage falloff 33m ✻ EMP Nerf EMP arc balance pass 35m ~/Documents/Code/Rust/crabapple  ✓ cargo test all doctests ran in 0.39s; merged doctests compilation took 0.38s 17m ~/Documents/Code/Rust/crabstep  ✓ cargo test all doctests ran in 0.83s; merged doctests compilation took 0.81s 21m ~/Documents/Code/Rust/imessage-exporter  ✻ claude Opus 5.5 (high) · Review GitHub issue 780 6m ✓ cargo test all doctests ran in 1.99s; merged doctests compilation took 1.95s 19m ~/Documents/Code/Rust/Logria  ✻ cargo watch -x test [Running 'cargo test'] test result: ok. 223 passed; 0 failed 45s ❯ n run · @ dir · / find · s sort  ↑↓ select · enter attach · space peek · ? controls · Ctrl-] flagship [?25l┌─ controls ──────────────────────────────────────────────┐│ Navigate ││ ↑↓ / kj move selection / find a task ││ Tab ⇧Tab jump section M next tagged ││ Act ││ enter attach r rerun finished ││ space peek X kill or remove ││ Organize ││ m tag in use R rename ││ ] flagship s cycle grouping ││ g assign group ││ Create ││ n run here @ run in a dir ││ Session ││ w save session o load session ││ Leave ││ q detach Q quit and kill ││ Attached ││ Ctrl-\ background Ctrl-] flagship / back │└─────────────────────────────────────────────────────────┘ ? esc close [?2026l[?25l
Binary file modified docs/img/controls.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading