Skip to main content
Version: v0.11.0

Get started

Pick the row that matches what you want to do.

I want to…CapabilityFirst pageYou need
Point my coding agent at the sandbox serviceSandbox serviceSandbox quickstartNode.js 22+, git, a sandbox service deployment, its URL, and a GitHub account enrolled in it
Try moca on my laptop in about five minutesHarnessHarness quickstartDocker (or podman's docker CLI) with Compose, curl, and a model credential
Use mocactl against a moca server someone runsHarnessUse mocactlNode.js 22+ and the server's control-plane URL
Deploy moca for a teamHarness, sandbox service, or bothDeploy and operateDepends on the path. The chooser lists each one

Install the client​

The sandbox service and the harness share one client, mocactl:

curl -fsSL https://raw.githubusercontent.com/rossoctl/moca/main/scripts/install-mocactl.sh | sh

What the installer does:

  • It needs Node.js 22 or later and curl.
  • It installs into ~/.local/bin, never edits your shell's rc files, and checks the download's SHA-256.
  • To choose a build, set MOCACTL_VERSION: latest (the default), edge (the newest build of main) or a release tag such as v0.10.0.
  • To install somewhere else, set MOCACTL_INSTALL_DIR.
mocactl --version # a release tag, edge-<sha>, or dev-<sha> from a checkout

Commands:

  • mocactl sbx … drives the sandbox service. It has its own login (mocactl sbx login).
  • The rest of mocactl (login, run, sessions, …) drives the harness.
  • mocactl COMMAND --help prints the syntax of one command.

What you cannot do locally (yet)​

There is no local way to run the sandbox service. It deploys to an OpenShift cluster plus one or more KVM hosts (install). To try it, deploy it, or use your team's deployment: you need its URL and a GitHub account enrolled in it. The harness runs locally under Docker Compose, as a trial.

Next​