Skip to content

Sessions

The durable thread your agent work runs on. Start one, pick the agent and model, set the autonomy, read the live conversation, review what happened.

A session is the durable thread your agent work runs on. You open the TUI, start a session, and every message, tool call, and result lands in it. Close the terminal and come back tomorrow — the session is still there, ready to resume.

A TUI session showing a user prompt, a bash tool call, and the assistant's reply. The context bar at the bottom shows the active agent, session ID, and model.

Everything else is a setting or a view on the session:

AxisWhat it controlsWhere you change it
AgentSystem prompt, tools, skills, default modelCtrl+A picker or /agent <name>
ModelThe LLM reasoning over the prompt and tool callsCtrl+K picker, /model <id>, or /models for the browser
AutonomyWhether the agent pauses for approval or keeps going/interactive, /auto [steps], /policy <name>
ThreadWhich conversation you’re on — browse, resume, rename, exportCtrl+B browser, /new, /rename, /export

Switching any of these mid-thread is expected. The session holds the transcript; agent, model, and autonomy are knobs you turn while the thread runs.

The default agent is always available: a generic assistant with the tools the runtime ships with. Everything else comes from capabilities. When you install a capability, its agents, tools, and skills all land in the same runtime and show up in the Ctrl+A picker. Switching agents does not switch runtimes — the conversation continues on the same session, with the new persona and toolset from the next turn on.

If you have not used the TUI yet, start with Quickstart — it walks you from install to first message. Then come back here and open Agent & model to load a capability and pick who you’re talking to.