Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.opencomputer.dev/llms.txt

Use this file to discover all available pages before exploring further.

Agent conversations can extend beyond a single prompt. Send follow-up prompts within the same session, resume a conversation in a new session, or reconnect to a running agent.

​
Follow-up Prompts

Use sendPrompt() to continue a conversation within the same running session: 
const session = await sandbox.agent.start({
  prompt: "Create a REST API with Express",
  onEvent: (event) => console.log(`[${event.type}]`, event),
});

await session.done;

// Send a follow-up in the same session
session.sendPrompt("Now add input validation to all endpoints");
await session.done;

​
Resuming Across Sessions

Resume continues a previous conversation in a new agent session. This is useful when the original session has ended or you want to fork the conversation. Capture the claude_session_id from the turn_complete event, then pass it as resume when starting a new session: 
let claudeSessionId: string;

const session1 = await sandbox.agent.start({
  prompt: "Set up a Next.js project with Tailwind",
  onEvent: (event) => {
    if (event.type === "turn_complete") {
      claudeSessionId = event.claude_session_id;
    }
  },
});
await session1.done;

// Later — possibly in a different sandbox forked from the same checkpoint
const session2 = await sandbox.agent.start({
  prompt: "Now add a dark mode toggle",
  resume: claudeSessionId,
  onEvent: (event) => console.log(event),
});
await session2.done;
resume is available in the TypeScript SDK only. Python SDK support is planned — use the HTTP API directly to pass the resume field.

​
Attach vs Resume

AttachResume
Session stateStill runningEnded or running
What happensReconnect to event streamNew session, continues conversation
SDK supportTypeScript, PythonTypeScript only

​
Interrupting

Stop the agent’s current turn: 
session.interrupt();
// The session emits an "interrupted" event
The agent stops working but the session stays alive — you can send a new prompt to continue.

​
Reconfiguring Mid-Session

Change model, tools, or working directory while the session is running: 
session.configure({
  model: "claude-sonnet-4-20250514",
  maxTurns: 20,
  allowedTools: ["Read", "Bash"],
});
The new configuration takes effect on the next turn.

​
Managing Sessions

​
Listing Sessions

const sessions = await sandbox.agent.list();
for (const s of sessions) {
  console.log(s.sessionID, s.running ? "running" : "stopped");
}

​
Attaching to a Running Session

Reconnect to an agent session that’s already running — useful after a network disconnect or when monitoring from a different client: 
const session = await sandbox.agent.attach(sessionId, {
  onEvent: (event) => console.log(event),
  onError: (data) => console.error(data),
});
Agent sessions are SDK-only — there is no CLI command for agents yet.
Back to Agents overview. See also: Events · Tools.