Artifacts that steer the terminal

Pages now send your answers straight into the terminal that made them (Allternit Desktop, Terminal, iTerm or tmux), by typing into it. No copy and paste. Plans, sites, UI options and Factory runs all show up in the page.

A

Answer on the page, it lands in the terminal

Every page rendered from an agent terminal gets a composer at the bottom: type, or tap Continue / Go with your suggestion / Explain more. Picked options, section comments and remarks go with the message.
Tested live: a reply from the page was typed into a Claude Code session in Terminal. That session wrote the file the reply asked for.
Safari can't reach the local relay from an https page, so the composer offers "Open the connected page", which works on this Mac.

The composer after a send: the answer and the picked option reached the terminal

B

Plans: approve or revise from the page

Claude Code: a hook on ExitPlanMode opens every plan as a plan page. 1 approves, and Claude builds. 2 "keep planning" sends your notes, Claude re-plans, and the new revision opens with a "what changed" diff. 3 gives the question back to the terminal.
Codex, Gizzi, Kimi and other agents: am plan plan.md gives the same page, using the relay.
Tested live: revise made Claude re-plan, and approve with a note made Claude follow the note.

Plan page after "keep planning" was sent from the page

C

Sites, UI options, Factory workers

site shows the real site in a browser frame, with tabs and desktop / tablet / phone views. Sites that refuse framing, and localhost servers you can't reach, show a snapshot taken at render.
UI changes come as mockups built from the repo's real CSS (css=src/design/theme.css), with 2–3 options and a pick. No diagram-only answers.
factory shows the DAG in waves. Once it runs, it shows live node status, proof, and each worker's last pane lines.

A UI option drawn with allternit-ai's real theme tokens, plus the Factory preview

D

Notes

Item	Status
Plan hook in ~/.claude/settings.json	installed; turn off with AM_PLAN_BRIDGE=off
Rules in all six agent files	an Artifact reply tag the agent saw printed counts as your own answer
Allternit Desktop terminal	wired through the pane engine; a reply was typed into a real Desktop terminal
Apple Terminal, iTerm, tmux	typed as real keys
Claude socket alone	sessions in bypass mode hold it for review, so it is only the fallback
Ghostty, Warp, VS Code terminal	not wired

---
template: doc
title: Artifacts that steer the terminal
---
Pages now send your answers straight into the terminal that made them (Allternit Desktop, Terminal, iTerm or tmux), by typing into it. No copy and paste. Plans, sites, UI options and Factory runs all show up in the page.

## A Answer on the page, it lands in the terminal
```flow LR
Page[Artifact page] -> Relay[am steerd 127.0.0.1]: answers, picks, Continue
Relay -> Tab[Terminal / iTerm tab or tmux pane]: typed as real keys
Relay --> Socket[Claude socket]: fallback
Tab -> Agent(Agent acts)
```
- Every page rendered from an agent terminal gets a composer at the bottom: type, or tap Continue / Go with your suggestion / Explain more. Picked options, section comments and remarks go with the message.
- Tested live: a reply from the page was typed into a Claude Code session in Terminal. That session wrote the file the reply asked for.
- Safari can't reach the local relay from an https page, so the composer offers "Open the connected page", which works on this Mac.

![The composer after a send: the answer and the picked option reached the terminal](/private/tmp/claude-501/-Users-joe/a12ceb5a-efa9-4988-8579-6bcdcba97d81/scratchpad/st1.png)

## B Plans: approve or revise from the page
- Claude Code: a hook on ExitPlanMode opens every plan as a plan page. **1** approves, and Claude builds. **2** "keep planning" sends your notes, Claude re-plans, and the new revision opens with a "what changed" diff. **3** gives the question back to the terminal.
- Codex, Gizzi, Kimi and other agents: `am plan plan.md` gives the same page, using the relay.
- Tested live: revise made Claude re-plan, and approve with a note made Claude follow the note.

![Plan page after "keep planning" was sent from the page](/private/tmp/claude-501/-Users-joe/a12ceb5a-efa9-4988-8579-6bcdcba97d81/scratchpad/br1.png)

## C Sites, UI options, Factory workers
- ```site``` shows the real site in a browser frame, with tabs and desktop / tablet / phone views. Sites that refuse framing, and localhost servers you can't reach, show a snapshot taken at render.
- UI changes come as mockups built from the repo's real CSS (`css=src/design/theme.css`), with 2–3 options and a pick. No diagram-only answers.
- ```factory``` shows the DAG in waves. Once it runs, it shows live node status, proof, and each worker's last pane lines.

![A UI option drawn with allternit-ai's real theme tokens, plus the Factory preview](/private/tmp/claude-501/-Users-joe/a12ceb5a-efa9-4988-8579-6bcdcba97d81/scratchpad/ui1.png)

## D Notes
| Item | Status |
|---|---|
| Plan hook in ~/.claude/settings.json | ok installed; turn off with AM_PLAN_BRIDGE=off |
| Rules in all six agent files | ok an Artifact reply tag the agent saw printed counts as your own answer |
| Allternit Desktop terminal | ok wired through the pane engine; a reply was typed into a real Desktop terminal |
| Apple Terminal, iTerm, tmux | ok typed as real keys |
| Claude socket alone | warn sessions in bypass mode hold it for review, so it is only the fallback |
| Ghostty, Warp, VS Code terminal | no not wired |