Repository navigation
Agent Deck 0.5
Firmware 0.5 for the M-VAVE FM-1, with the matching host daemon (protocol v5).
Most of the new controls are in the daemon and work on firmware 0.3 and 0.4 too; 0.5 itself adds the context gauges, the + marker and the new sounds.
What's new
Sounds (firmware 0.5)
- Blocked alert: three rising calls, three times, about 1.7x as loud as the other chimes. On older firmware a blocked agent gets the attention chime three times in a row instead.
- Feedback sounds: a faint tick for menu moves, preset arming, marks and view changes; a soft rising or falling blip when you approve / start / send or deny / stop.
- A quieter "done", and a quiet double note when an agent's context is getting full.
- MENU → SETTINGS: feedback sounds on/off, blocked alert loud/normal (
ui_sounds,alert).
Groups
- LFO + key: mark or unmark that agent. While any are marked, GLO + REC / FX / ENV / SEQ acts on the marked agents only; GLO + LFO clears the marks.
- ARP + key: toggle auto-approve on that agent.
Seeing more
- DIFF view: EDIT on DETAIL now cycles OUTPUT → INFO → DIFF: what the agent has changed since the last commit, per file, plus the last three commits.
- Context gauges (firmware 0.5): a bar at the end of each Claude Code agent's row and under DETAIL's status line, with a one-time warning at
ctx_warn_pct(default 80%). - MENU → FLEET: every agent on one screen with state, time in state and context size; pick a row to open it.
- SEL held: when the prompt has numbered choices, exactly those keys light, and the footer names the one you pick.
Getting around
- HOME again on the GRID: jump to the agent that has waited longest.
- K1 on the MENU page: a page at a time.
Menu
- THIS AGENT → COMMANDS:
/compact,/clear,/context,/review,/status(configurable). - SEND PROMPT → AGAIN: resend what the agent was last asked.
- NEW AGENT → IN A NEW WORKTREE: makes a git worktree next to the repository (
<repo>-wt1on branchdeck/wt1) and starts the agent there. - SETTINGS → DESKTOP NOTIFY: optional desktop notifications (
notify, off by default).
Install
pip install mido python-rtmidi
python3 firmware-build/tools/fm1_install.py agentdeck-0.5.fwsc
python3 host/agentdeck.py --backend autoFlashing custom firmware is at your own risk: the FM-1's flash is single-bank, and an interrupted write can leave the unit dark until rescued. Read the arrival-day section of the README before a first flash.
Status
- The 0.5 package is built with the JieLi toolchain and boots in fm1-emu, rendering all four pages. It has not yet been run on real hardware; 0.3 is what is installed on the author's FM-1, with the daemon from this release driving it.
- The new sounds have been measured in the host harness recording, not yet heard through an FM-1.
- The context gauge assumes a 200k-token window and treats a session seen above that as a 1M window; set
ctx_windowif that is wrong for you. - The INFO view, gauges and blocked reasons read Claude Code's own session logs (read-only), an internal format that may change.
- Worktree spawn and desktop notifications have had unit-level checks only.
agentdeck-0.5.fwsc SHA-256: 31e9cea67c32cd917e614d5ffdf6e1546368fe2252e4556e974b6f7c9f392670