# OpenComputer

> Cloud sandboxes for running AI agents

## Docs

- [Agents](https://docs.opencomputer.dev/agent-sessions/agents.md): Reusable agent configuration
- [API / SDK / CLI reference](https://docs.opencomputer.dev/agent-sessions/api-reference.md): Every action in the Durable Agent Sessions API, with its TypeScript SDK call and oc CLI command
- [Artifacts & previews](https://docs.opencomputer.dev/agent-sessions/artifacts.md): Session files, links, and preview URLs
- [Authentication](https://docs.opencomputer.dev/agent-sessions/authentication.md): Org keys, browser-safe client tokens, and bring-your-own model keys
- [Channels](https://docs.opencomputer.dev/agent-sessions/channels.md): Bind sessions to external threads
- [Credentials](https://docs.opencomputer.dev/agent-sessions/credentials.md): Run models Managed (billed to your credits) or on your own provider keys
- [Custom runtimes](https://docs.opencomputer.dev/agent-sessions/custom-runtimes.md): Package your own agent implementation as a runtime
- [Events](https://docs.opencomputer.dev/agent-sessions/events.md): The append-only log: read, stream, filter by level, and resume
- [Flue](https://docs.opencomputer.dev/agent-sessions/flue.md): Deploy a Flue app as an OpenComputer agent
- [Messaging](https://docs.opencomputer.dev/agent-sessions/messaging.md): Append user input to a session
- [Durable Agent Sessions](https://docs.opencomputer.dev/agent-sessions/overview.md): Define an agent, then run resumable, steerable sessions
- [Quickstart](https://docs.opencomputer.dev/agent-sessions/quickstart.md): Start a session, stream it live, and steer it
- [Repos & GitHub](https://docs.opencomputer.dev/agent-sessions/repos.md): Give sessions private code without giving agents GitHub credentials
- [Deployments & revisions](https://docs.opencomputer.dev/agent-sessions/revisions.md): Deploy and version agent behavior
- [Runtime tools](https://docs.opencomputer.dev/agent-sessions/runtime-tools.md): The tools a runtime can use — what to rely on when you write prompts
- [Runtimes](https://docs.opencomputer.dev/agent-sessions/runtimes.md): Runtime engine selected per agent
- [Schedules](https://docs.opencomputer.dev/agent-sessions/schedules.md): Run an agent on a cron — each firing starts a new session
- [Sessions](https://docs.opencomputer.dev/agent-sessions/sessions.md): Durable, resumable agent execution
- [Skills](https://docs.opencomputer.dev/agent-sessions/skills.md): Reusable instructions an agent loads when it needs them
- [Slack](https://docs.opencomputer.dev/agent-sessions/slack.md): Message an agent from Slack
- [Triggers](https://docs.opencomputer.dev/agent-sessions/triggers.md): Start and resume sessions from external events
- [Watches](https://docs.opencomputer.dev/agent-sessions/watches.md): Wake a session when a PR it opened gets checks, reviews, comments, or merges
- [Webhooks](https://docs.opencomputer.dev/agent-sessions/webhooks.md): Deliver session events to your backend
- [Workspaces](https://docs.opencomputer.dev/agent-sessions/workspaces.md): Prepared repo environments, rebuilt on push
- [Create Reservation](https://docs.opencomputer.dev/api-reference/capacity/create-reservations.md)
- [Get Calendar](https://docs.opencomputer.dev/api-reference/capacity/get-calendar.md)
- [List Reservations](https://docs.opencomputer.dev/api-reference/capacity/list-reservations.md)
- [Create Checkpoint](https://docs.opencomputer.dev/api-reference/checkpoints/create.md)
- [Delete Checkpoint](https://docs.opencomputer.dev/api-reference/checkpoints/delete.md)
- [Fork from Checkpoint](https://docs.opencomputer.dev/api-reference/checkpoints/fork.md)
- [List Checkpoints](https://docs.opencomputer.dev/api-reference/checkpoints/list.md)
- [Restore Checkpoint](https://docs.opencomputer.dev/api-reference/checkpoints/restore.md)
- [Create Exec Session](https://docs.opencomputer.dev/api-reference/exec/create-session.md)
- [Kill Exec Session](https://docs.opencomputer.dev/api-reference/exec/kill-session.md)
- [List Exec Sessions](https://docs.opencomputer.dev/api-reference/exec/list-sessions.md)
- [Run Command](https://docs.opencomputer.dev/api-reference/exec/run.md)
- [Delete File or Directory](https://docs.opencomputer.dev/api-reference/files/delete.md)
- [Generate Download URL](https://docs.opencomputer.dev/api-reference/files/generate-download-url.md)
- [Generate Upload URL](https://docs.opencomputer.dev/api-reference/files/generate-upload-url.md)
- [List Directory](https://docs.opencomputer.dev/api-reference/files/list-directory.md)
- [Create Directory](https://docs.opencomputer.dev/api-reference/files/mkdir.md)
- [Read File](https://docs.opencomputer.dev/api-reference/files/read.md)
- [Signed Download](https://docs.opencomputer.dev/api-reference/files/signed-download.md)
- [Signed Upload](https://docs.opencomputer.dev/api-reference/files/signed-upload.md)
- [Write File](https://docs.opencomputer.dev/api-reference/files/write.md)
- [API Reference](https://docs.opencomputer.dev/api-reference/overview.md): Complete REST API reference for OpenComputer
- [Create Patch](https://docs.opencomputer.dev/api-reference/patches/create.md)
- [Delete Patch](https://docs.opencomputer.dev/api-reference/patches/delete.md)
- [List Patches](https://docs.opencomputer.dev/api-reference/patches/list.md)
- [Create Preview URL](https://docs.opencomputer.dev/api-reference/preview/create.md)
- [Delete Preview URL](https://docs.opencomputer.dev/api-reference/preview/delete.md)
- [List Preview URLs](https://docs.opencomputer.dev/api-reference/preview/list.md)
- [Rotate Preview-URL Auth Token](https://docs.opencomputer.dev/api-reference/preview/rotate-auth.md)
- [Create PTY Session](https://docs.opencomputer.dev/api-reference/pty/create.md)
- [Kill PTY Session](https://docs.opencomputer.dev/api-reference/pty/kill.md)
- [Resize PTY](https://docs.opencomputer.dev/api-reference/pty/resize.md)
- [Create Sandbox](https://docs.opencomputer.dev/api-reference/sandboxes/create.md)
- [Kill Sandbox](https://docs.opencomputer.dev/api-reference/sandboxes/delete.md)
- [Get Sandbox](https://docs.opencomputer.dev/api-reference/sandboxes/get.md)
- [Get Sandbox Tags](https://docs.opencomputer.dev/api-reference/sandboxes/get-tags.md)
- [Hibernate Sandbox](https://docs.opencomputer.dev/api-reference/sandboxes/hibernate.md)
- [List Sandboxes](https://docs.opencomputer.dev/api-reference/sandboxes/list.md)
- [Set Sandbox Tags](https://docs.opencomputer.dev/api-reference/sandboxes/set-tags.md)
- [Set Timeout](https://docs.opencomputer.dev/api-reference/sandboxes/set-timeout.md)
- [Wake Sandbox](https://docs.opencomputer.dev/api-reference/sandboxes/wake.md)
- [Create Snapshot](https://docs.opencomputer.dev/api-reference/snapshots/create.md)
- [Delete Snapshot](https://docs.opencomputer.dev/api-reference/snapshots/delete.md)
- [Get Snapshot](https://docs.opencomputer.dev/api-reference/snapshots/get.md)
- [List Snapshots](https://docs.opencomputer.dev/api-reference/snapshots/list.md)
- [Sandbox Usage](https://docs.opencomputer.dev/api-reference/usage/get-sandbox-usage.md)
- [Usage Aggregator](https://docs.opencomputer.dev/api-reference/usage/get-usage.md)
- [List Tag Keys](https://docs.opencomputer.dev/api-reference/usage/list-tags.md)
- [Create Webhook](https://docs.opencomputer.dev/api-reference/webhooks/create.md)
- [Delete Webhook](https://docs.opencomputer.dev/api-reference/webhooks/delete.md)
- [List Deliveries](https://docs.opencomputer.dev/api-reference/webhooks/deliveries-list.md)
- [Get Delivery](https://docs.opencomputer.dev/api-reference/webhooks/delivery-get.md)
- [Get Webhook](https://docs.opencomputer.dev/api-reference/webhooks/get.md)
- [List Webhooks](https://docs.opencomputer.dev/api-reference/webhooks/list.md)
- [Redeliver](https://docs.opencomputer.dev/api-reference/webhooks/redeliver.md)
- [Test Webhook](https://docs.opencomputer.dev/api-reference/webhooks/test.md)
- [Update Webhook](https://docs.opencomputer.dev/api-reference/webhooks/update.md)
- [Browser Sessions](https://docs.opencomputer.dev/browser-sessions/overview.md): Preview: create cloud browser sessions for Playwright, Magnitude, and profile-backed web automation
- [Checkpoints](https://docs.opencomputer.dev/cli/checkpoint.md): Snapshot, fork, and restore from the CLI
- [Running Commands](https://docs.opencomputer.dev/cli/exec.md): Execute shell commands from the CLI
- [CLI](https://docs.opencomputer.dev/cli/overview.md): Manage sandboxes from your terminal
- [Patches](https://docs.opencomputer.dev/cli/patch.md): Attach scripts to checkpoints from the CLI
- [Preview URLs](https://docs.opencomputer.dev/cli/preview.md): Expose sandbox ports from the CLI
- [Sandbox Management](https://docs.opencomputer.dev/cli/sandbox.md): Create, manage, and control sandbox lifecycles from the CLI
- [Secrets](https://docs.opencomputer.dev/cli/secrets.md): Manage secret stores and secrets from the CLI
- [Shell](https://docs.opencomputer.dev/cli/shell.md): Interactive terminal sessions from the CLI
- [Agent Skill](https://docs.opencomputer.dev/guides/agent-skill.md): Use AI agents to manage cloud sandboxes with natural language
- [Browser Automation](https://docs.opencomputer.dev/guides/browser-automation.md): Run headless and headed browsers inside OpenComputer sandboxes — for scraping, logged-in workflows, and AI-driven automation.
- [Build a Lovable Clone](https://docs.opencomputer.dev/guides/build-a-lovable-clone.md): Build an open-source AI app builder using OpenComputer sandboxes
- [How It Works](https://docs.opencomputer.dev/how-it-works.md): Architecture and key technical decisions
- [Introduction](https://docs.opencomputer.dev/introduction.md): Cloud sandboxes for AI apps
- [Quickstart](https://docs.opencomputer.dev/quickstart.md): Create your first sandbox in 2 minutes
- [oc checkpoint](https://docs.opencomputer.dev/reference/cli/checkpoint.md): Manage sandbox checkpoints
- [oc config](https://docs.opencomputer.dev/reference/cli/config.md): CLI configuration
- [oc exec](https://docs.opencomputer.dev/reference/cli/exec.md): Execute commands inside a sandbox
- [CLI Reference](https://docs.opencomputer.dev/reference/cli/overview.md): Every command, subcommand, and flag
- [oc patch](https://docs.opencomputer.dev/reference/cli/patch.md): Manage checkpoint patches
- [oc preview](https://docs.opencomputer.dev/reference/cli/preview.md): Manage preview URLs
- [oc sandbox](https://docs.opencomputer.dev/reference/cli/sandbox.md): Manage sandbox lifecycle
- [oc sandbox scaling](https://docs.opencomputer.dev/reference/cli/scaling.md): Resize sandboxes, configure autoscale, and manage scaling locks from the CLI
- [oc shell](https://docs.opencomputer.dev/reference/cli/shell.md): Interactive terminal access
- [Exec](https://docs.opencomputer.dev/reference/python-sdk/exec.md): Run commands and manage exec sessions
- [Filesystem](https://docs.opencomputer.dev/reference/python-sdk/filesystem.md): Read, write, and manage files
- [Image](https://docs.opencomputer.dev/reference/python-sdk/image.md): Declarative sandbox image builder
- [Python SDK](https://docs.opencomputer.dev/reference/python-sdk/overview.md): Complete Python SDK reference
- [PTY](https://docs.opencomputer.dev/reference/python-sdk/pty.md): Interactive terminal sessions
- [Sandbox](https://docs.opencomputer.dev/reference/python-sdk/sandbox.md): Create, connect, and manage sandbox lifecycle
- [Scaling](https://docs.opencomputer.dev/reference/python-sdk/scaling.md): Resize a sandbox manually, autoscale on memory pressure, or freeze its resources.
- [Secret Stores](https://docs.opencomputer.dev/reference/python-sdk/secrets.md): Manage secrets and egress control
- [Snapshots](https://docs.opencomputer.dev/reference/python-sdk/snapshots.md): Pre-built sandbox environments
- [Exec](https://docs.opencomputer.dev/reference/typescript-sdk/exec.md): Run commands and manage exec sessions
- [Filesystem](https://docs.opencomputer.dev/reference/typescript-sdk/filesystem.md): Read, write, and manage files
- [Image](https://docs.opencomputer.dev/reference/typescript-sdk/image.md): Declarative sandbox image builder
- [TypeScript SDK](https://docs.opencomputer.dev/reference/typescript-sdk/overview.md): Complete TypeScript SDK reference
- [PTY](https://docs.opencomputer.dev/reference/typescript-sdk/pty.md): Interactive terminal sessions
- [Sandbox](https://docs.opencomputer.dev/reference/typescript-sdk/sandbox.md): Create, connect, and manage sandbox lifecycle
- [Scaling](https://docs.opencomputer.dev/reference/typescript-sdk/scaling.md): Resize a sandbox manually, autoscale on memory pressure, or freeze its resources.
- [Secret Stores](https://docs.opencomputer.dev/reference/typescript-sdk/secrets.md): Manage secrets and egress control
- [Snapshots](https://docs.opencomputer.dev/reference/typescript-sdk/snapshots.md): Pre-built sandbox environments
- [Usage & Tags](https://docs.opencomputer.dev/reference/typescript-sdk/usage.md): Query sandbox usage, group by tag, and manage sandbox tags
- [Reading the Calendar](https://docs.opencomputer.dev/reserved-capacity/calendar.md): Preview reservable capacity and existing commitments per 15-minute interval
- [Concepts](https://docs.opencomputer.dev/reserved-capacity/concepts.md): Intervals, reservations, the reservation log, and the per-org cap
- [Reserved Capacity](https://docs.opencomputer.dev/reserved-capacity/overview.md): Commit memory capacity to future 15-minute intervals at a discounted rate
- [Reserving Capacity](https://docs.opencomputer.dev/reserved-capacity/reserving.md): Write flow, idempotency, atomicity, and the audit list
- [Usage and Overage](https://docs.opencomputer.dev/reserved-capacity/usage-and-overage.md): How reserved capacity is consumed and how overage is calculated
- [Burst Sandboxes](https://docs.opencomputer.dev/sandboxes/burst-sandboxes.md): Alpha lower-cost sandboxes that preserve disk across infrastructure restarts
- [Checkpoints](https://docs.opencomputer.dev/sandboxes/checkpoints.md): Snapshot and fork sandbox state
- [Elasticity](https://docs.opencomputer.dev/sandboxes/elasticity.md): Dynamically scale sandbox memory and CPU — automatically, manually, or via the in-VM API
- [Interactive Terminals](https://docs.opencomputer.dev/sandboxes/interactive-terminals.md): Full PTY sessions inside sandboxes
- [Mounts](https://docs.opencomputer.dev/sandboxes/mounts.md): Mount S3, GCS, Azure Blob, SFTP, WebDAV, and Dropbox into a sandbox via FUSE
- [Sandboxes](https://docs.opencomputer.dev/sandboxes/overview.md): The compute primitive — full Linux VMs in the cloud
- [Patches](https://docs.opencomputer.dev/sandboxes/patches.md): Scripts that run when forking from a checkpoint
- [Preview URLs](https://docs.opencomputer.dev/sandboxes/preview-urls.md): Expose sandbox ports to the internet
- [Running Commands](https://docs.opencomputer.dev/sandboxes/running-commands.md): Execute shell commands inside a sandbox
- [Secrets](https://docs.opencomputer.dev/sandboxes/secrets.md): Inject encrypted secrets into sandboxes without exposing them to the VM
- [Signed URLs](https://docs.opencomputer.dev/sandboxes/signed-urls.md): Generate pre-signed URLs for direct file uploads and downloads without API keys
- [Templates](https://docs.opencomputer.dev/sandboxes/templates.md): Define sandbox environments programmatically with the Image builder and Snapshots
- [Timeout & Hibernation](https://docs.opencomputer.dev/sandboxes/timeout.md): Control how long a sandbox stays alive when idle
- [Usage Monitoring](https://docs.opencomputer.dev/sandboxes/usage.md): Inspect a sandbox's memory allocation and actual utilization over time
- [Webhooks](https://docs.opencomputer.dev/sandboxes/webhooks.md): Subscribe to sandbox lifecycle events — signed, retried, and redeliverable
- [Working with Files](https://docs.opencomputer.dev/sandboxes/working-with-files.md): Read, write, and manage files inside a sandbox
- [Troubleshooting](https://docs.opencomputer.dev/troubleshooting.md): Common errors and debugging tips