Quickstart

From this Project to a remote computer.

opencloudbox gives a local coding agent a separate computer. After one-time setup, the first useful moment is a Project, a ready Session, and one remote command result.

Before you begin

opencloudbox is in technical preview. The commands below describe the locked v0.1 interface; the verified package and hosted MCP connection paths will be published here when access opens.

Start the first Session.

The shortest path keeps setup visible instead of pretending the product begins at a magic command.

Prepare

Install and sign in

The planned package name is opencloudbox. Account setup and sign-in happen once per device.

Terminal

$ npm install -g opencloudbox

Terminal

$ ocbox login

Connect

Create the Project

Run from a repository to use filtered file upload, or pass a repository URL for remote clone.

Terminal

$ ocbox init

Terminal

$ ocbox start --repo https://github.com/you/project

Run

Execute remotely

The Session owns the command, process, and remote workspace. Your editor and coding agent remain local.

Terminal

$ ocbox exec npm test
All checks passed
exit 0

One control plane, three surfaces.

Choose the entry point that fits the work. They operate on the same account, Projects, and Sessions.

CLILocal install for terminal-first control and provider credentials.

Projects
Sessions
Secrets

Remote computerProvider-isolated command execution and workspace.

Hosted MCP exposes explicit Session tools to a coding agent without a local CLI install.

Web app provides secrets, visibility, lifecycle control, usage, and recovery.

Select the infrastructure relationship.

The provider choice changes ownership and billing, not the Project or Session model.

opencloudbox managed

opencloudbox supplies compute and handles the provider relationship.

provider: ocbox

Bring your own provider

The provider account is yours. Its credential remains on the local device.

provider: daytona

Project movement is explicit.

Start from a Git repository or selected local files. opencloudbox does not silently perform bidirectional merge.

Local ProjectApply exclusions

Upload bundleVerify extraction

Remote workspaceExecute commands

Use ocbox sync diff before pulling remote changes. The CLI should make the file boundary legible before it changes your Project.

CLI command contract.

A compact reference to the v0.1 surface. Availability can differ during technical preview.

ocbox init

Create local project configuration.

ocbox start

Start a Session and prepare the Project.

ocbox exec <command...>

Run a command in the active Session.

ocbox status

Inspect the current Project and Session.

ocbox ls

List available Sessions.

ocbox stop

Stop compute and preserve according to provider policy.

ocbox destroy

Destroy the Session and its remote workspace.

ocbox snapshot

Create a provider-supported workspace snapshot.

ocbox sync push

Send selected Project files explicitly.

ocbox sync diff

Preview local and remote file differences.

ocbox sync pull

Retrieve selected remote changes.

ocbox env set

Create or update a workload-secret reference.

Prepare the local agent.

Codex is the first supported coding-agent workflow. Claude Code follows the same local-agent, remote-execution model.

Terminal

$ ocbox agent setup codex

Terminal

$ ocbox agent doctor