Cap 2: Instalación de Orca

Instalación

Orca ofrece instaladores para los tres sistemas operativos principales. Todas las descargas están disponibles en la página de releases de GitHub.

macOS

Descarga el .dmg desde GitHub Releases o usa Homebrew:

brew install --cask orca

También puedes descargar el archivo .dmg directamente, abrirlo y arrastrar Orca a la carpeta de Aplicaciones.

Windows

Descarga el instalador .exe desde GitHub Releases y ejecútalo. El instalador configura automáticamente el PATH para que el CLI orca esté disponible desde cualquier terminal.

Alternativamente, con winget:

winget install stablyai.orca

Linux

Para distribuciones basadas en Debian/Ubuntu:

# Descargar el .deb desde GitHub Releases
sudo dpkg -i orca_latest_amd64.deb

Para Arch Linux:

# Disponible en AUR
yay -S orca-bin

Para otras distribuciones, descarga el AppImage:

chmod +x Orca-latest.AppImage
./Orca-latest.AppImage

Verificar la instalación

Una vez instalado, verifica que tanto la aplicación como el CLI funcionan:

orca --version
# Orca v1.x.x

Abre la aplicación y deberías ver la pantalla de bienvenida con la opción de abrir o clonar un repositorio.

Configuración inicial

Al abrir Orca por primera vez, el asistente te guía a través de la configuración:

1. Configurar Git

Orca necesita acceso a Git. Verifica que tienes Git 2.20 o superior:

git --version
# git version 2.45.0

2. Detectar agentes instalados

Orca escanea automáticamente tu sistema buscando agentes CLI compatibles:

# Agentes que Orca detecta automáticamente
claude --version    # Claude Code
codex --version     # OpenAI Codex CLI
gemini --version    # Google Gemini CLI
aider --version     # Aider

Si un agente está en tu PATH, Orca lo detecta y lo añade como opción disponible.

3. Configurar agentes manualmente

Si un agente no fue detectado, puedes añadirlo en Settings > Agents:

{
  "agents": {
    "claude": {
      "command": "claude",
      "args": ["--dangerously-skip-permissions"],
      "env": {}
    },
    "codex": {
      "command": "codex",
      "args": ["--full-auto"],
      "env": {}
    }
  }
}

Abrir tu primer proyecto

Con Orca configurado, abre un proyecto existente:

1. File > Open Folder o Ctrl+O / Cmd+O
2. Selecciona la raíz de tu repositorio Git
3. Orca detecta que es un repo Git y habilita todas las funciones de worktree

sequenceDiagram
    participant U as Usuario
    participant O as Orca
    participant G as Git

    U->>O: Abrir carpeta de proyecto
    O->>G: Detectar repo Git
    G-->>O: Repo encontrado
    O->>G: Listar worktrees existentes
    G-->>O: Lista de worktrees
    O-->>U: UI lista con panel de worktrees

Estructura de la interfaz

La interfaz de Orca tiene estas zonas principales:

• Sidebar izquierdo: explorador de archivos, worktrees activos y agentes
• Panel central: editor de código con tabs
• Panel inferior: terminal(es) donde corren los agentes
• Panel derecho (opcional): diff viewer, browser integrado
• Barra de estado: branch actual, worktree activo, agentes corriendo

Atajos de teclado esenciales

Atajo	Acción
Ctrl/Cmd + Shift + P	Command palette
Ctrl/Cmd + T	Nueva terminal / nuevo agente
Ctrl/Cmd + Shift + W	Nuevo worktree
Ctrl/Cmd + Tab	Cambiar entre tabs de agentes
Ctrl/Cmd + D	Abrir diff viewer
Ctrl/Cmd + B	Abrir browser integrado

Actualizar Orca

Orca se actualiza automáticamente por defecto. Para verificar manualmente:

# Desde el CLI
orca update

# O dentro de la app: Help > Check for Updates

Para desactivar actualizaciones automáticas, ve a Settings > General > Auto-update.