Repository navigation
v0.4.0
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/v2and the HTTP contracttmag/http/v2, under/v2/. Clients move with tmag. tmag watchmay 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 waitdrops--after; it andsend --waitread session records.- Hook contact alone logs no event; a session's
last_hook_atis 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
peersskill 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 --lastright aftersend --waitwaits 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