Skip to content

Agent Deck 0.6

Choose a tag to compare

@kevinelliott kevinelliott released this 13 Nov 08:07
· 12 commits to main since this release

Firmware 0.6 for the M-VAVE FM-1, with the matching host daemon (protocol v6).

The screen is new in this release, so most of it needs the firmware; the queue, the auto-approve rules and the knob combos are in the daemon and work on older firmware too.

What's new

The screen

  • Colour means state everywhere: amber is waiting on you, green is finished, red is broken, white is working, grey is at rest.
  • Header: a logo whose nine pads are the first nine slots in their state colours, the page name with a page indicator, a host light, and a chip per state with its count.
  • GRID rows: a state-coloured edge, a state icon (a spinner while working, a blinking warning sign while blocked, a tick, a cross), a kind tag in the agent's colour, time in state, flags and the context gauge.
  • Boxes: press HOME again on the GRID to see the agents as tiles filled in their state colours instead of rows. The tiles resize with the deck, from four big ones down to all 27 keys of the page; the choice is remembered.
  • DETAIL: the state as a pill, a context bar, a tag for the INFO / DIFF views, and text coloured by what it is.
  • ABOUT: a fifth page (also MENU → ABOUT) with the firmware and protocol version, the device identity, the host connection, the daemon's version and backend, agents in use and uptime.
  • A power-on splash, an empty-deck screen that says what to do next, and ALL CLEAR on APPROVALS when nobody is waiting.

Prompt queue and pipelines

  • A prompt sent to a BLOCKED agent is queued and goes out once the agent is free (Q on its row). queue_when_working does the same for prompts sent mid-turn.
  • A preset can be a pipeline: {"label": ..., "steps": [...]}, one step per finished turn. A "test > review > commit" preset is built in.

Auto-approve rules

  • Before auto-approve answers a prompt, the daemon checks what the agent wants to run and the prompt on screen against auto_never (by default rm -r/-f, git push, git reset --hard, sudo, --force, drop table, mkfs/dd). On a match it leaves the prompt to you and sounds the alert.
  • This is a text match, not a sandbox: a risky command phrased another way gets through.

Knobs with a button held

  • PLAY + PRESETS: choose which agent PLAY starts.
  • SEQ + PRESETS: how many times repeat mode sends.
  • SEL + K1: scroll DETAIL a page at a time.
  • LFO + K4: step through the marked agents.

Also

  • Follow: the selection can jump to an agent when it blocks (MENU → SETTINGS).
  • Mute: silence one agent's sounds and alerts (MENU → THIS AGENT).
  • Changed: jump to the agent that has waited longest is now GLO again on APPROVALS; HOME again on the GRID is the list / boxes toggle.

Install

pip install mido python-rtmidi
python3 firmware-build/tools/fm1_install.py agentdeck-0.6.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

  • This package is installed on the author's FM-1 and the daemon drives it there over protocol v6. It was built with the JieLi toolchain and booted in fm1-emu first, where all five pages and the box view render.
  • The individual screens, the smallest box sizes (more than 16 agents on a page) and the sounds have had emulator and harness time, not yet a careful pass on the hardware.
  • The queue, pipelines, auto-approve rules and knob combos have been exercised against a stub backend, not yet over long sessions with real agents.
  • The INFO view, gauges and blocked reasons read Claude Code's own session logs (read-only), an internal format that may change.

agentdeck-0.6.fwsc SHA-256: ab984d61b09d499b23fe06bae17dbd1fe52839157e3fbc6d911e17e398815a7d