Skip to content

Agent Deck 0.5

Choose a tag to compare

@kevinelliott kevinelliott released this 13 Nov 07:10
· 16 commits to main since this release

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>-wt1 on branch deck/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 auto

Flashing 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_window if 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