smith9 · Agent runtime smith.sys9.ai

Agent Sessions that pick up where you left off.

Run managed agents in a persistent workspace. Configure a provider for your project, choose an agent, and continue the same conversation across Turns. Hosted environments run on run9; you can also connect a local machine as an Env.

Persistent workspacesContinuing conversationsProject providersCLI · API · Portal
create · run · continue

One workspace. Conversations that continue.

Create an Env, then create a Session for an agent in that workspace. Each input runs a Turn; later Turns resume that Session's conversation. Idle Sessions do not need a live agent process between Turns.

Install the sys9 CLI and sign in. Before running the example, use project settings to configure and activate a Codex provider. provider ls shows the current configuration; the Env and Session commands return the IDs used in later steps.

shared Env workspace Session continuation provider configuration
sys9 smith · example commands
# sign in, then configure a Codex provider in project settings
$ sys9 smith auth login
$ sys9 smith provider ls

# create a shared workspace for your Sessions
$ sys9 smith env create --name workspace

# replace ENV_ID and SESSION_ID with the returned IDs
$ sys9 smith session create --env ENV_ID --runtime codex --name first-task
$ sys9 smith session run SESSION_ID --input "Describe the workspace"

# continue the same conversation
$ sys9 smith session run SESSION_ID --input "Suggest a next step"
the model

Env → Session → Turn.

A workspace holds the files. A Session holds the conversation. A Turn does the next piece of work.

Env

The workspace

An Env provides a persistent workspace and runtime home shared by its Sessions. Hosted Envs use managed runtimes; a connected local Env uses its own installed agents and provider configuration.

Session

The conversation

A Session belongs to an Env and preserves an agent conversation across Turns. Create separate Sessions for separate conversations while using the same Env files.

Turn

The next execution

A Turn runs one input in a Session. Successful Turns advance its saved conversation; failed or stopped Turns do not advance continuation. A new input activates the runtime when needed.

managed agents

Choose the runtime for the task.

The managed catalog includes Codex, Claude Code, Gemini CLI, Pi, and OpenCode. Configure the provider for each agent you use; available models depend on that provider.

Codex Claude Code Gemini CLI Pi OpenCode
get started

Start a Session on smith9.

Sign in, select your project, and configure an agent provider. Create an Env and send the first input through the portal or CLI.