Skip to content
LogoLogo

Orca

The CreateOS recipe for Orca runs a whole Orca workspace on a disposable microVM instead of your laptop. It can optionally install Claude Code, Codex, Cursor, OpenCode, or Pi into that workspace.

It lives in its own repository:

github.com/NodeOps-app/createos-orca-plugin

Prerequisites

Install the createos CLI and authenticate:

curl -sfL https://raw.githubusercontent.com/NodeOps-app/createos-cli/main/install.sh | sh -
createos login

Use export CREATEOS_API_KEY=<key> instead of signing in for CI or headless use.

As with Herdr, there are two sets of credentials in play: yours, on your machine, which create the sandbox; and the agent's own provider credentials, which belong inside the workspace.

Install

If createos sandbox --help lists setup, use the CLI command below. Otherwise use the manual installation that follows.

createos sandbox setup orca

To install by hand, use Orca's Settings → Plugins → Install from git URL with:

https://github.com/NodeOps-app/createos-orca-plugin.git#v0.1.0

Why it is a separate repository

Orca installs a plugin by cloning an entire repository and reading its manifest from the root, so a plugin cannot live in a subdirectory of a larger repository the way the others do. Orca also refuses symlinks anywhere in plugin content, which rules out the workarounds that would otherwise make a monorepo layout work.

See also

  • Herdr, the other integration that runs the agent inside the sandbox
  • Concepts, sandboxes, networks, ingress, snapshots