THE PANEL
- The project you are in, a row a process.
- Rows stand by role; a row that wants you is in the accent, where it stands.
- At the foot, a line for every project with something running, the open one marked.
- The process under the cursor fills the rest of the window. enter puts the keys in it; ctrl-space brings them back.
- q leaves. Everything keeps running.
- ❝a conversation with Claude Code118k
- ○the stack: what keeps running:8123
- ❯a shell, or a client
- ✓a check that passed4m
- ✗a check that failed2m
- ◌a server outside conn:5432
AGENTS
- Agents reach the same verbs from a shell, and are told so when conn starts them.
- What an agent starts under a name is a row on the panel, with a pane you can go into and read.
- What it waited on is a check. The rest is the stack.
- st lists the checks as they were last run here, and enter runs them; x takes one off for good. ss does the same for the stack. Nothing is declared.
- Every conversation conn starts is told what the project runs.
> bring the code to the manual ● Read panel.go, cli.go, server.go ● Bash
- conn lswhat runs in the project
- conn l NAME|:PORT|PIDwhat a process said
- conn u -w -- COMMANDrun it and wait: its output, its exit status as conn's
- conn u NAME -- COMMANDstart it in a pane of its own
- conn u NAME -w -- COMMANDdeclare a check the project keeps, and run it
- conn r NAME|:PORT|PIDrestart it
- conn x NAME|:PORT|PIDstop it
- conn downthe server and everything in it
INTENT
- conn is told nothing about what a project runs. A key names an intent.
- Carried out through conn before, by you or by an agent, it runs again as it did.
- Not yet, and Claude Code is asked once. enter runs the answer and keeps it.
- st asks for the checks, ss for the stack, c for how to talk to a process.
- A kept command that fails at once is asked about again, and offered corrected.
- aa hands a row to an agent with its last lines. af hands everything that failed.
conn~/projects/w0zro/conn
WAITING
- A conversation that stops to ask, or whose turn ends while you are elsewhere, waits on you: in the accent.
- tab goes to the one that has waited longest. From inside any pane, ctrl-space then tab.
- The band at the foot counts the conversations waiting across every project. The terminal's title says it too, and the bell rings as one more does.
conn · 2 waiting
INSTALL
$
curl -fsSL https://conn.w0zro.com/install.sh | sh- macOS and Linux. Needs tmux and git; lsof for the ports; claude for conversations.
- One Go binary. It brings up a tmux server of its own and leaves yours alone.
- man conn is the reference. The operating manual says how it is worked. The source is on GitHub.