mirror of https://github.com/stablyai/orca.git synced 2026-10-03 16:02:11 +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

18 KiB

Raw Blame History

Orca

_{English · 中文 · 日本語 · 한국어 · Español · Português}

L'orchestrateur d'IA pour les builders 100x.
Lancez Codex, Claude Code, OpenCode ou Pi côte à côte — chacun dans son propre worktree, le tout suivi au même endroit.

Télécharger Orca

_{Sous Windows ? Prenez la dernière RC — elle inclut des correctifs Windows.}

Fonctionnalités

Companion mobile Surveillez et pilotez vos agents depuis votre téléphone — soyez notifié quand un agent termine, et envoyez des instructions de suivi où que vous soyez. App Store iOS · TestFlight · APK Android 0.0.50 · Docs →
Worktrees parallèles Lancez un même prompt sur cinq agents, chacun dans son propre worktree git isolé — comparez les résultats et mergez le gagnant. Docs →
Splits de terminal Terminaux de niveau Ghostty avec rendu WebGL, splits infinis et un scrollback qui survit aux redémarrages. Docs →
Mode Design Cliquez sur n'importe quel élément d'UI dans une vraie fenêtre Chromium pour envoyer son HTML, son CSS et une capture recadrée directement dans le prompt de votre agent. Docs →
GitHub & Linear, natifs Parcourez PRs, issues et boards de projet dans l'app — ouvrez un worktree depuis n'importe quelle tâche et reviewz sans changer de contexte. Docs →
Worktrees SSH Faites tourner des agents sur une machine distante costaude, avec édition de fichiers, git et terminaux complets — reconnexion auto et port forwarding inclus. Docs →
Annoter les diffs IA Posez des commentaires sur n'importe quelle ligne de diff et renvoyez-les à l'agent — review, édition et commit sans quitter Orca. Docs →
Glisser-déposer vers les agents L'éditeur VS Code avec autosave partout — glissez fichiers ou images directement dans le prompt d'un agent. Docs →
Orca CLI Les agents pilotent aussi Orca — scriptez n'importe quel workflow avec `orca worktree create`, `snapshot`, `click` et `fill`. Docs →

Aussi dans la boîte :

Quick open — Cherchez parmi worktrees, fichiers, agents, commandes et contexte du repo sans quitter votre flow.
Sélecteur de comptes & suivi d'usage — Suivez l'usage Claude et Codex et les resets de rate limit, et basculez de compte à chaud sans vous reconnecter.
Aperçus riches du repo — Prévisualisez Markdown, images, PDF et docs du repo dans le workspace.
Computer Use — Laissez les agents piloter des apps desktop et l'UI visible quand un workflow demande une vraie interaction.
Notifications et non-lus — Sachez quand un agent termine ou a besoin d'attention, puis marquez des fils comme non lus pour y revenir plus tard.
Et bien plus encore — on ship tous les jours, donc cette liste est toujours en retard. Le changelog est la vraie liste des features.

Agents pris en charge

Fonctionne avec n'importe quel agent CLI — s'il tourne dans un terminal, il tourne dans Orca.

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

Installation

Desktop — macOS, Windows, Linux

Télécharger depuis onOrca.dev
Ou récupérez un build directement : macOS Apple Silicon · macOS Intel · Windows (.exe) · Linux AppImage · Tous les builds
Sous Windows : utilisez la dernière RC (v1.4.147-rc.3) — elle inclut des correctifs Windows absents de la stable.
Vous lancez orca serve sur un serveur Linux headless ? Consultez le guide serveur Linux headless.

Ou via un gestionnaire de paquets :

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

# Arch Linux (AUR) — ou stably-orca-git pour compiler depuis les sources
yay -S stably-orca-bin

Companion mobile — iOS, Android

Associez-la à l'app de bureau pour surveiller et piloter vos agents depuis votre téléphone.

iOS : Télécharger sur l'App Store ou rejoindre TestFlight
Android : Télécharger l'APK 0.0.50

Communauté & support

Discord : Rejoignez la communauté sur Discord.
Twitter / X : Suivez @orca_build pour les news et annonces.
WeChat : Scannez pour rejoindre le groupe WeChat 10 de la communauté Orca.
Feedback & idées : On ship vite. Il manque quelque chose ? Demandez une feature.
Confidentialité : Voir la doc confidentialité & télémétrie pour ce qu'Orca collecte en anonyme et comment désactiver la télémétrie.
Soutenez-nous : Mettez une star sur ce repo pour suivre nos ships quotidiens.

Développement

Envie de contribuer ou de lancer le projet en local ? Consultez notre guide CONTRIBUTING.md.

Builds signés

Signature de code Windows sponsorisée / fournie par SignPath.io, certificat par SignPath Foundation.

Licence

Orca est libre et open source sous la licence MIT.

18 KiB Raw Blame History

Orca

Télécharger Orca

Fonctionnalités

Companion mobile

Worktrees parallèles

Splits de terminal

Mode Design

GitHub & Linear, natifs

Worktrees SSH

Annoter les diffs IA

Glisser-déposer vers les agents

Orca CLI