Your first session

A session in Termio is a real terminal running one thing — an agent, a dev server, or a plain shell. Here's the path from a fresh launch to a working setup.

Open a project

From the welcome screen, choose Open Project and pick a folder. Termio adds it to the sidebar and remembers it under Recent for next time. A project is just a working directory — the agents you launch inside it start there.

Launch an agent

With a project selected, start a new session and pick an agent — Claude Code, Codex, Gemini, or any other CLI you have installed. Termio opens it in a real terminal at the project root. You type into it exactly as you would in any terminal; the agent's TUI renders natively.

The sidebar shows the session's live status — working, idle, attention, or done. The sidebar guide explains each state; the one to watch for is attention, which means the agent is blocked on a prompt or a permission and needs you back.

Split the window

Most real work wants more than one pane. Split the current pane to the right with ⌘D or downward with ⌘⇧D, then drop another session into the new pane — an agent in one, your dev server in another, a shell in a third. Panes tile as a tree, so you can nest splits into any layout.

Move focus between panes with ⌘⌥ + an arrow key, temporarily zoom the focused pane to fill the window with ⌘⇧↩, and close it with ⌘W. Every shortcut is rebindable — see Keyboard shortcuts.

A note on session lifetime

Sessions are live processes, not saved transcripts. When you quit Termio, the shells and agents exit — reopening the app starts fresh. The read-only session trace (see the Info pane) keeps a rendered record of what happened, but the running process itself doesn't survive a quit.

Next steps