Shell

Shell gives the agent terminals that keep running: dev servers, watchers, test suites, REPLs, tunnels, tails. Bay 01, shipping since 0.1.0.

When a shell beats bash

The task	In a tool call	In a shell
Start a dev server	Blocks until killed, or is backgrounded and lost	Returns when the port answers, keeps running
Watch a type checker	Re-read the whole log every turn	One message when it breaks, one when it is fixed
A REPL	One-shot; state gone by the next call	Stays open, takes input later
A crash	Noticed when something else fails	Reported as a failure when it happens

Rule of thumb: anything that would still be running when the turn ends belongs in a shell.

Three views of one stream

Every shell’s output is kept three ways at once, and each has a job:

• Log — normalised, numbered lines for the agent. Carriage returns and progress bars collapse to their final state, so a spinner costs one line instead of ten thousand.
• Screen — an emulated terminal, which is what you see in the panel. vitest looks like vitest.
• Raw ring — the bytes, so a panel opened late can replay what it missed.

Limits

• timeoutSeconds — stop it after this long, busy or not. Good for probes: watch the DB for two minutes.
• idleTimeoutSeconds — stop it after this much silence. Never use it for dev servers, which are idle when healthy.
• logFile — also write the clean log to ~/.cache/opencode-cockpit/logs/<id>.log.

Whatever ends a shell is recorded, so the summary says why: a time limit, an idle limit, the agent, you, or a crash with its exit code.