mirror of https://github.com/stablyai/orca.git synced 2026-10-05 16:02:22 +00:00

Files

T

Neil 90801e2deb feat(agents): add first-class ZCode harness (#22464 )

* feat(agents): add first-class ZCode harness

Add ZCode (Z.ai's `zcode` CLI) as a supervised Orca agent: managed lifecycle
hooks on local, SSH and Windows hosts; status, question and approval reporting;
synthetic status titles; session resume; orchestration worker launch options;
and desktop + mobile agent-picker registration.

Written against the newly open-sourced `zai-org/ZCode` (agent CLI 0.16.9), not
against a remembered screen:

- ZCode's hook runner writes a Claude-compatible stdin alias set, so it routes
through the existing Claude-compatible vendor path while keeping its own
identity in the sidebar.
- `PermissionRequest` fires only once the approval card is on screen and racing
the user's answer, so it is proof the pane is blocked, not an auto-approval.
- ZCode's clarification tool is literally `AskUserQuestion` with Claude's
questions/options shape, so Orca's question card renders it unchanged.
- ZCode's `hooks.enabled` defaults to false, which is why configured hooks were
reported as never firing; the installer sets it.
- ZCode renames its own process to `zcode-cli`, so the expected foreground
process cannot be the launch command or dispatch refuses the pane.
- ZCode emits no OSC title in any state and repaints its ASCII banner forever,
so readiness comes from Orca's synthetic hook title and launch drafts wait on
the composer box rather than on a quiet render window.

Three files crossed their max-lines limit, so each is split along a real seam:
command-line entrypoint parsing out of agent process recognition, skill
classification out of skill root discovery, and registry coverage out of the
remote hook installer tests.

Refs #10564

* fix(zcode): drop the session-option catalog and pin the orchestration contract

ZCode's CLI exposes no `--model` flag at all, and the session-option launch path
refuses to apply any option until a model id is chosen. A catalog therefore could
not deliver `--mode` per worker, and would have accepted `--model` only to drop
it silently. Take opencode's position instead: no catalog, so `worker-start
--model` is refused with a clear message and ZCode launches with the model from
its own config. `--mode` stays reachable through agent args, which is also how
the yolo default is applied.

Add a contract test covering the parts that make ZCode a usable worker:
dispatchable foreground process, stdin prompt delivery, the prompt staying out
of the launch command, and the composer-gated draft paste.

* refactor(zcode): reuse shared helpers and cut the harness down

No behaviour change; every ZCode test still passes.

- Use installer-utils' own `hookDefinitionHasManagedCommand` instead of
re-walking a hook definition by hand, which also drops a local string reader.
- Share one `readZCodeEventMap` instead of keeping the same narrowing in both
hook-settings and hook-config-json.
- Collapse five identical error returns into one `zcodeHookError` builder, and
return early from the status branches instead of assigning through `let`.
- Split the event-to-status decision out of `normalizeZCodeEvent` into a pure
`readZCodeTurn`, so the normalizer reads as decide-then-build and stops
computing the tool name for events that never look at it.
- Take a script file name in `readManagedZCodeHookEvents` like its siblings,
which removes a `Parameters<typeof …>` indirection at the call site.
- Drop the unused `ZCodeHookEvent` export and inline a single-use path helper.
- Correct a stale comment: ZCode's loader is a strict `JSON.parse`, so the
in-place edit preserves key order and indentation, not comments.

* fix(zcode): address review — keep unmanaged event keys, correct comment, de-dupe README

- `removeZCodeManagedHooks` deleted any event key whose list ended up empty, so an
unrelated `"Notification": []` the user wrote was removed as collateral whenever a
managed hook elsewhere made the write happen. Only touch an event Orca actually
owned something in; covered by a new regression test.
- The `isNewTurnEvent` comment claimed UserPromptSubmit was ZCode's only turn
boundary while the expression below it also returned true for SessionStart. Say
what the code does: SessionStart lands the idle boundary, UserPromptSubmit is the
turn boundary (the Codex/Claude shape).
- ZCode appeared twice in the README's single agent-badge block; keep the
local-icon entry the link checker validates and drop the favicon duplicate.

* docs(zcode): call out that the desktop bundle's CLI cannot open a session

From live testing on #22464: pointing `zcode` at the desktop app's bundled
`glm/zcode.cjs` installs Orca's hooks fine but then fails with
`Cannot find package '@zcode/tui'`, so the pane never opens a session. The
symptom reads as a broken harness when the CLI simply has no TUI. Say which
build to use and how to check before reporting a problem.

Reported-by: JWu527

2026-09-25 02:17:51 -07:00

16 KiB

Raw Blame History

Orca

_{English · 中文 · 日本語 · 한국어 · Français · Português}

El orquestador de IA para desarrolladores 100x.
Ejecuta Codex, Claude Code, OpenCode u Pi en paralelo — cada uno en su propio worktree, supervisados desde un solo lugar.

Descargar Orca

Características

App companion móvil Supervisa y dirige a tus agentes desde el teléfono — recibe una notificación cuando un agente termine y envía instrucciones de seguimiento desde cualquier lugar. App Store de iOS · APK para Android · Docs →
Worktrees en paralelo Lanza un mismo prompt a cinco agentes, cada uno en su propio worktree de git aislado — compara los resultados y haz merge del ganador. Docs →
Terminales divididas Terminales de nivel Ghostty con renderizado WebGL, divisiones infinitas y un scrollback que sobrevive a los reinicios. Docs →
Modo diseño Haz clic en cualquier elemento de UI en una ventana real de Chromium para enviar su HTML, su CSS y una captura recortada directo al prompt de tu agente. Docs →
GitHub y Linear, nativos Explora PRs, issues y tableros de proyecto dentro de la app — abre un worktree desde cualquier tarea y revisa sin cambiar de contexto. Docs →
Worktrees por SSH Ejecuta agentes en una máquina remota potente con edición completa de archivos, git y terminales — con reconexión automática y reenvío de puertos incluidos. Docs →
Anotar diffs de IA Deja comentarios en cualquier línea de un diff y envíalos de vuelta al agente — revisa, edita y haz commit sin salir de Orca. Docs →
Arrastra archivos a los agentes El editor de VS Code con autoguardado en todas partes — arrastra archivos o imágenes directo al prompt de un agente. Docs →
Orca CLI Los agentes también manejan Orca — automatiza cualquier flujo de trabajo con `orca worktree create`, `snapshot`, `click` y `fill`. Docs →

También incluye:

Apertura rápida — Busca entre worktrees, archivos, agentes, comandos y contexto del repo sin salir de tu flujo.
Cambio de cuenta y seguimiento de uso — Consulta el uso de Claude y Codex y los reinicios de límites de uso, y cambia de cuenta al instante sin volver a iniciar sesión.
Previews ricos del repo — Previsualiza Markdown, imágenes, PDFs y documentos del repo en el workspace.
Computer Use — Deja que los agentes manejen apps de escritorio y UI visible cuando un flujo de trabajo necesita interacción real.
Notificaciones y estado de no leído — Entérate cuando un agente termine o necesite tu atención, y marca hilos como no leídos para retomarlos después.
Y muchas, muchas más — lanzamos a diario, así que esta lista siempre va atrasada. El changelog es la verdadera lista de funciones.

Agentes compatibles

Funciona con cualquier agente CLI — si corre en una terminal, corre en Orca.

Claude Code Codex Grok Cursor GitHub Copilot Muse ZCode OpenCode Amp OpenClaude Antigravity Pi oh-my-pi Hermes Agent Goose Auggie Autohand Code Charm Cline Codebuff Command Code Continue Droid Kilocode Kimi Kiro Mistral Vibe Qwen Code Rovo Dev + any CLI agent

Instalación

Escritorio — macOS, Windows, Linux

Descarga desde onOrca.dev
O descarga un build directamente: macOS Apple Silicon · macOS Intel · Windows (.exe) · Linux AppImage · Todos los builds

O mediante un gestor de paquetes:

# macOS (Homebrew)
brew install --cask stablyai/orca/orca

# Arch Linux (AUR) — or stably-orca-git to build from source
yay -S stably-orca-bin

App companion móvil — iOS, Android

Vincúlala con tu app de escritorio para supervisar y dirigir a tus agentes desde el teléfono.

iOS: Descargar desde App Store
Android: Descargar el APK

Comunidad y soporte

Discord: Únete a la comunidad en Discord.
Twitter / X: Sigue a @orca_build para novedades y anuncios.
Feedback e ideas: Lanzamos rápido. ¿Te falta algo? Pide una nueva feature.
Privacidad: Consulta la documentación de privacidad y telemetría para saber qué datos anónimos de uso recopila Orca y cómo desactivar su envío.
Muéstranos tu apoyo: Dale una estrella a este repo para seguir nuestros lanzamientos diarios.

Desarrollo

¿Quieres contribuir o ejecutar Orca localmente? Consulta nuestra guía CONTRIBUTING.md.

Licencia

Orca es libre y de código abierto bajo la Licencia MIT.

16 KiB Raw Blame History

Orca

Descargar Orca

Características

App companion móvil

Worktrees en paralelo

Terminales divididas

Modo diseño

GitHub y Linear, nativos

Worktrees por SSH

Anotar diffs de IA

Arrastra archivos a los agentes

Orca CLI