01 Open agentic runtime

The open
agentic runtime.

Build persistent coding agents locally. Give them tools, skills, channels, and a workspace—then run the same agent anywhere.

npx -y @opencomputer/blue@latest init my-agent

BLUE / RUNTIME MAP

AGENT READY
01 LOCAL build + test
02 STATE durable sessions
03 SHIP same runtime

ONE AGENT · EVERY ENVIRONMENT

01

Local first

No cloud account or container required to start.

02

Durable by design

Persistent sessions, replayable events, isolated workspaces.

03

Open & composable

Plain files, TypeScript configuration, portable agents.

02 Hand this to your coding agent

One prompt.
Your first agent.

Copy the instructions into Codex or Claude Code. It will scaffold an agent with the Blue CLI, customize it, and run a local session.

Create a Blue agent in this workspace using the @opencomputer/blue CLI.

1. Verify that Node.js 22 or newer is available.
2. Run:
   npx -y @opencomputer/blue@latest init my-agent
3. Replace the starter text in my-agent/agent/instructions.md with clear instructions for the agent I describe.
4. Review blue.config.ts and agent/agent.ts. Keep the opencode runtime unless the project requires otherwise.
5. From my-agent, start the local runtime with:
   npx -y @opencomputer/blue@latest dev
6. In another terminal, test it with:
   npx -y @opencomputer/blue@latest session "Inspect the workspace and introduce yourself"

Explain the files you created and any decisions you made. Do not install the package globally.

03 A small, legible stack

From idea to
running agent.

  1. 01

    Initialize

    blue init my-agent

    Scaffold the agent, workspace, tools, skills, and evals.

  2. 02

    Shape the agent

    agent/instructions.md

    Define its role in plain Markdown. Add code only where it helps.

  3. 03

    Run a session

    blue dev

    Start locally, iterate fast, and keep every session isolated.