Instala ORCA

Una línea en Linux, macOS o Windows (WSL2). Puedes correrla de nuevo sin problema y nunca necesita sudo.

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

Qué necesitas

  • Linux (x86_64 o arm64), macOS (Apple silicon o Intel), o Windows con WSL2.
  • Hasta ahora lo probamos en Linux. macOS y WSL2 siguen los mismos pasos, pero aún no los hemos probado; cuéntanos en GitHub si algo falla.
  • Node.js 20 o más reciente.
  • Un asistente de IA instalado y con sesión iniciada: Claude Code, Codex u opencode.
  • Una computadora que esté prendida a la hora de tus rutinas.

Instalación

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

Luego abre http://127.0.0.1:7171

Qué hace el instalador

  1. Descarga el panel y herdr 0.9.5, el espacio de trabajo de terminal de código abierto sobre el que corre, y revisa la descarga contra una suma de verificación fija.
  2. Instala en ~/.local/share/operio-orca y deja el comando operio-orca en ~/.local/bin.
  3. Lo arranca con tu computadora: un servicio de usuario de systemd en Linux, un agente de launchd en macOS. Agrega --no-service para omitirlo.
  4. Agrega las cinco rutinas gratis, apagadas hasta que las actives.

¿Prefieres leerlo antes?

Descarga el script, léelo y luego córrelo. O clona el repositorio y córrelo desde ahí.

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)

En Windows, ORCA corre dentro de WSL2, el sistema Linux que viene con Windows. Lo configuras una vez y luego usas la misma instalación de una línea.

  1. Abre PowerShell como administrador, instala WSL2 con Ubuntu y reinicia si Windows te lo pide:
    wsl --install -d Ubuntu
  2. Abre Ubuntu desde el menú Inicio y crea tu usuario. Dentro de Ubuntu, instala Node.js 20 o más reciente y tu asistente de IA.
  3. Corre la misma instalación de una línea dentro de Ubuntu:
    curl -fsSL https://make.operio.work/install.sh | bash

Que arranque con Ubuntu

Las instalaciones nuevas de WSL2 traen systemd apagado, así que el instalador arranca ORCA a mano y muestra esta receta. Activa systemd una vez, reinicia WSL y corre de nuevo la línea de instalación: desde entonces ORCA arranca con Ubuntu.

  1. En Ubuntu:
    printf '[boot]\nsystemd=true\n' | sudo tee -a /etc/wsl.conf
  2. En PowerShell:
    wsl --shutdown
  3. Abre Ubuntu de nuevo y corre la línea de instalación otra vez:
    curl -fsSL https://make.operio.work/install.sh | bash

El soporte para WSL2 es nuevo. Si algo no funciona, cuéntanos en GitHub.

Úsalo desde tu celular

ORCA escucha solo en 127.0.0.1. Déjalo así y entra con una de estas opciones.

Tailscale (red privada, HTTPS)

  1. Comparte el panel dentro de tu red privada:
    tailscale serve --bg 7171
  2. Agrega el nombre que muestra a ~/.config/operio-orca/env:
    OPERIO_ORCA_ALLOWED_HOSTS=<machine>.<tailnet>.ts.net
  3. Reinicia y abre ese nombre en tu celular:
    operio-orca restart

Las alertas en el celular necesitan HTTPS, así que esta es la forma de tenerlas.

Túnel SSH

Desde el dispositivo que quieres usar; luego abre http://127.0.0.1:7171 en él:

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

Nunca lo expongas a internet: sin reenvío de puertos, sin enlaces públicos. No tiene inicio de sesión, así que quien lo alcance lo puede usar.

Comandos del día a día

operio-orca status
Si está corriendo, y dónde
operio-orca restart
Reinicia después de cambiar la configuración
operio-orca stop
Lo detiene hasta que lo inicies de nuevo
operio-orca start
Lo inicia de nuevo
operio-orca open
Lo abre en tu navegador
operio-orca doctor
Revisa la instalación y muestra cómo arreglar lo que falle
operio-orca logs
El registro del panel (logs herdr, logs routines; -f para seguirlo)
operio-orca backup
Guarda configuración, rutinas, borradores y bitácora en un archivo
operio-orca restore ARCHIVO
Regresa un respaldo (conserva una copia de lo que había)
operio-orca llm set NOMBRE
Guarda una clave de API para tus agentes (oculta al escribirla o por tubería, nunca como argumento)
operio-orca llm list
Las claves guardadas, por nombre y últimos 4 caracteres (llm unset NOMBRE quita una)
operio-orca llm apply
Reinicia herdr para que los agentes reciban las claves (solo si ninguno está trabajando)
operio-orca llm test claude
Una prueba mínima con las claves cargadas: ok, o por qué no (claude, codex, opencode, gemini)

¿Por qué operio-orca y no solo orca? Ubuntu y muchos escritorios Linux ya traen un programa llamado orca: el lector de pantalla de GNOME. Un nombre distinto evita que se confundan.

Actualizar

operio-orca update

Actualiza el panel y herdr juntos, a versiones probadas entre sí. Úsalo en lugar de actualizar herdr por separado.

Para solo ver si hay una versión nueva, sin instalar nada:

operio-orca update --check

Prueba la demo

Un segundo panel en el puerto 7172 con dos negocios ficticios, Harbor Street Bistro y Brightside Dental. Sin datos reales, sin costo, y nunca toca tu propia configuración.

operio-orca demo
La inicia
operio-orca demo --lang es
La reproduce en español
operio-orca demo --reset
Empieza desde cero
operio-orca demo --stop
La detiene

Desinstalar

operio-orca uninstall

Quita el panel y su servicio. Agrega --purge para borrar también tu configuración, borradores y registros en ~/.config/operio-orca. Tus asistentes de IA y su trabajo no se tocan.

¿Prefieres no correrlo tú?

Operio opera las rutinas por ti, conectadas a tus herramientas reales y vigiladas para que sigan funcionando.

Habla con Operio