Local first
No cloud account or container required to start.
01 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
ONE AGENT · EVERY ENVIRONMENT
No cloud account or container required to start.
Persistent sessions, replayable events, isolated workspaces.
Plain files, TypeScript configuration, portable agents.
02 Hand this to your coding 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.
Help me build a persistent coding agent with Blue.
Use the @opencomputer/blue CLI directly:
npx -y @opencomputer/blue@latest init my-agent
Then customize my-agent/agent/instructions.md for the agent I describe, check blue.config.ts and agent/agent.ts, and run the agent locally from that directory:
npx -y @opencomputer/blue@latest dev
Test it from a second terminal with:
npx -y @opencomputer/blue@latest session "Inspect the workspace and introduce yourself"
Use Node.js 22 or newer, keep the default opencode runtime unless there is a concrete reason to change it, and summarize what you changed when you are done.
03 A small, legible stack
blue init my-agent
Scaffold the agent, workspace, tools, skills, and evals.
agent/instructions.md
Define its role in plain Markdown. Add code only where it helps.
blue dev
Start locally, iterate fast, and keep every session isolated.