Every day

Terminals

How the app opens shells on the server, what tmux gives you, and what happens when you close the window.

The app opens real terminals on the server, over the system ssh binary, in the project folder you are looking at. There is no web shell and no relay: it is the same connection you would open yourself.

Sessions survive

Every terminal is a tmux session. Close the app, close the laptop, lose the network: the session keeps running and you find it again where you left it. This is the whole reason work moves off the laptop in the first place.

Prompt markers

core.system sets OSC 133 markers in zsh and bash. They let the app tell one command from the next in a stream of bytes: it can show you where a command started, how long it took, and whether it failed, without parsing your prompt.

The dev command

The agent binary is also linked as dev. In a plain SSH terminal, dev gives the same operations the app performs — the same handlers, the same refusals. Nothing the app can do is hidden behind the app.

CommandWhat it does
dev statuswhat runs, the ports, the services
dev up, down, restarta project, or all
dev logs my-project -fthe project’s journal, followed
dev sync my-projectgit pull, then dependencies
dev attach my-projectprints the tmux line that opens its window
dev branchthe branch each project sits on, or switches one
dev db urlthe connection string, the shell, a dump, an import
dev doctora short diagnosis of the machine

Nothing to prefix. The agent reads its enrolment and its entitlement from files only root can open, so when dev is typed by an account that cannot open them, the command re-runs itself under sudo -n — the passwordless sudo the hardening leaves the dev user. Where that sudo is missing, it says so rather than answering with a refusal that names the wrong cause.

dev with no argument prints that grammar. Add --json to any of them and the agent’s own answer comes back instead of a rendering of it — which is what an agent, or a script, reads. Typing dev from your own terminal rather than from the app’s is the same thing: see your own client.

Colours

The terminal keeps a proper ANSI palette, because Claude Code, Codex and the tools around them depend on it. It is desaturated and fitted to the theme you chose. Everything around the terminal stays monochrome.