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 / /models browser, or /model <id>
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.

The same sessions run in the browser. Chat shows every session in the workspace in one list, with the runtime and what it costs in view.