Install ORCA

One line on Linux, macOS or Windows (WSL2). It is safe to run again, and it never needs sudo.

curl -fsSL https://make.operio.work/install.sh | bash

What you need

  • Linux (x86_64 or arm64), macOS (Apple silicon or Intel), or Windows through WSL2.
  • Tested by us on Linux so far. macOS and WSL2 follow the same steps but are not tested yet; tell us on GitHub if something fails.
  • Node.js 20 or newer.
  • An AI assistant installed and signed in: Claude Code, Codex or opencode.
  • A computer that is on when your routines are scheduled.

Install

curl -fsSL https://make.operio.work/install.sh | bash

Then open http://127.0.0.1:7171

What the installer does

  1. Downloads the panel and herdr 0.9.5, the open-source terminal workspace it runs on, and checks the download against a fixed checksum.
  2. Installs to ~/.local/share/operio-orca and puts the operio-orca command in ~/.local/bin.
  3. Starts it with your computer: a systemd user service on Linux, a launchd agent on macOS. Add --no-service to skip that.
  4. Adds the five free routines, turned off until you switch them on.

Prefer to read it first?

Download the script, read it, then run it. Or clone the repository and run it from there.

curl -fsSLo install.sh https://make.operio.work/install.sh
less install.sh
bash install.sh
git clone https://github.com/operio-work/orca
cd orca && bash install.sh

Windows (WSL2)

On Windows, ORCA runs inside WSL2, the Linux system built into Windows. Set it up once, then use the same one-line install.

  1. Open PowerShell as administrator, install WSL2 with Ubuntu, and restart if Windows asks:
    wsl --install -d Ubuntu
  2. Open Ubuntu from the Start menu and create your user. Inside Ubuntu, install Node.js 20 or newer and your AI assistant.
  3. Run the same one-line install inside Ubuntu:
    curl -fsSL https://make.operio.work/install.sh | bash

Make it start with Ubuntu

New WSL2 installs have systemd off, so the installer starts ORCA by hand and prints this recipe. Turn systemd on once, restart WSL, then run the install line again: from then on ORCA starts with Ubuntu.

  1. In Ubuntu:
    printf '[boot]\nsystemd=true\n' | sudo tee -a /etc/wsl.conf
  2. In PowerShell:
    wsl --shutdown
  3. Open Ubuntu again and run the install line once more:
    curl -fsSL https://make.operio.work/install.sh | bash

WSL2 support is new. If something does not work, tell us on GitHub.

Use it from your phone

ORCA listens on 127.0.0.1 only. Keep it that way and reach it through one of these.

Tailscale (private network, HTTPS)

  1. Share the panel inside your private network:
    tailscale serve --bg 7171
  2. Add the name it prints to ~/.config/operio-orca/env:
    OPERIO_ORCA_ALLOWED_HOSTS=<machine>.<tailnet>.ts.net
  3. Restart, then open that name on your phone:
    operio-orca restart

Phone alerts need HTTPS, so this is the way to get them.

SSH tunnel

From the device you want to use, then open http://127.0.0.1:7171 on it:

ssh -N -L 7171:127.0.0.1:7171 you@this-computer

Never expose it to the internet: no port forwarding, no public links. There is no login, so anyone who can reach it can use it.

Everyday commands

operio-orca status
Is it running, and where
operio-orca restart
Restart after changing settings
operio-orca stop
Stop it until you start it again
operio-orca start
Start it again
operio-orca open
Open it in your browser
operio-orca doctor
Check the install and print the fix for anything wrong
operio-orca logs
The panel log (logs herdr, logs routines; -f to follow)
operio-orca backup
Save settings, routines, drafts and the journal to one file
operio-orca restore FILE
Put a backup back (keeps a copy of what was there)
operio-orca llm set NAME
Save an API key for your agents (typed hidden or piped in, never an argument)
operio-orca llm list
The keys set, by name and last 4 characters (llm unset NAME removes one)
operio-orca llm apply
Restart herdr so the agents get the keys (only when none is working)
operio-orca llm test claude
One tiny prompt with the keys loaded: ok, or why not (claude, codex, opencode, gemini)

Why operio-orca and not just orca? Ubuntu and many Linux desktops already ship a program called orca: the GNOME screen reader. A distinct name keeps the two apart.

Update

operio-orca update

Updates the panel and herdr together, to versions that are tested with each other. Use this instead of updating herdr on its own.

To only see whether there is a newer version, without installing anything:

operio-orca update --check

Try the demo

A second panel on port 7172 with two fictional businesses, Harbor Street Bistro and Brightside Dental. No real data, no cost, and it never touches your own setup.

operio-orca demo
Start it
operio-orca demo --lang es
Play it in Spanish
operio-orca demo --reset
Start over
operio-orca demo --stop
Stop it

Uninstall

operio-orca uninstall

Removes the panel and its service. Add --purge to also delete your settings, drafts and logs in ~/.config/operio-orca. Your AI assistants and their work are left alone.

Rather not run it yourself?

Operio runs the routines for you, connected to your real tools and watched so they keep working.

Talk to Operio