Skip to main content

Prerequisites

  • Node.js 22 or newer
  • an OpenComputer account

1. Create the agent

Use . instead of my-agent to initialize an empty current directory. The initializer creates one hello-world agent.

2. Log in

The CLI opens the OpenComputer device-login flow and stores the login locally. The production API at https://app.opencomputer.dev is used by default.

3. Watch development deployments

On the first run, choose an existing cloud project or create a new one. The process prints the project dashboard URL, watches opencomputer/, and deploys changes to development. Open the dashboard playground or use the CLI to send a message. The watcher stays open like a live-reload development process:
This command does not start a local agent server or a browser application.

4. Change the agent

Edit opencomputer/agents/hello-world/agent.ts:
Saving the file publishes a new development deployment. Start a new playground or client session to test it; an existing session keeps the deployment it started with. See Projects for project selection and Secrets and runtime variables for automatic development secret synchronization.

5. Deploy to production

The command builds an immutable deployment and advances the production alias. Development remains available for subsequent edits. See Deployments and environments for aliases and version history.

Projects

Add more agents and understand project bindings.

Reactive agents

Add models, tools, MCP servers, and subagents.