Skip to content

v0.4.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 08:00
· 32 commits to main since this release
v0.4.0
7a5a083

tmag 0.4 makes the state layer thin, leaning on tmux, the kernel and plain files, and lets agents notice and settle work they share.

Breaking changes

  • The JSON contract is tmag/v2 and the HTTP contract tmag/http/v2, under /v2/. Clients move with tmag.
  • tmag watch may send a new snapshot at any time, whenever it cannot vouch that it sent every event since (the log rotated past it, or was recreated); a client rebuilds its view from it.
  • tmag wait drops --after; it and send --wait read session records.
  • Hook contact alone logs no event; a session's last_hook_at is kept at most every 10 seconds and reported with the session.
  • State lives in a new default directory, $XDG_STATE_HOME/tmag/v2/<realm>. 0.4 starts empty there and leaves the 0.3 directory as it is; running sessions reappear with their next hook. Remove the old directory once you no longer need it.

Agents working with each other

  • The peers skill looks at other agents when a signal says one shares your work (changes you did not make, branch switches, force-pushes, stopping shared processes) or when you ask, and never routinely.
  • After a refusal or failure, the verbs agents use print a next: line on stderr saying what to do, claiming no more about a prompt's delivery than tmag proved.
  • tmag read --last right after send --wait waits for the reply Claude Code writes after its Stop hook.

Reliability and performance

  • What hooks accept is bounded where it is read, so records and events stay small whatever an agent sends.
  • Session records and pane options are the truth; the event log tells what changed, best effort, numbered without gaps.
  • A Codex pane proven by its process is no longer replaced by a title inference, so its first turn shows no Detach/Attach flicker.
  • Six Codex daemons in a soak: 426 hooks/s, p99 20 ms, 0.29 events per hook, no hook errors (0.3.0: 404 hooks/s, p99 27 ms).

Upgrading

prefix + U updates the plugin, which fetches the 0.4.0 binary on its next load; then prefix + M-a brings the agent plugins to 0.4.0. Codex asks again to approve tmag's hooks (/hooks). See Installation and Updates.

What's Changed

  • fix: bound state growth and enforce replay and hook deadlines by @ChrAlpha in #1
  • refactor: simplify long-running reliability by @ChrAlpha in #2
  • ci: shorten race checks and fix answer hook timeouts by @ChrAlpha in #4
  • fix(attach): keep a pane's proof when only its evidence changes by @ChrAlpha in #6
  • fix(state): let readers observe atomic replacement of published metadata by @ChrAlpha in #5
  • fix(read): wait for a reply Claude Code writes after its Stop hook by @ChrAlpha in #7
  • feat(peers): look at peers on signals and say what to do after refusals by @ChrAlpha in #8
  • refactor!: thin the state layer onto records, pane options and plain files by @ChrAlpha in #9

Full Changelog: v0.3.0...v0.4.0