mirror of https://github.com/stablyai/orca.git synced 2026-10-09 00:02:39 +00:00

Files

T

0677271709 fix(orchestration): reap leaked worker terminals via process-incarnation fallback — stops an unbounded PTY/process leak on Remote Server (OOM / cgroup PID exhaustion) (#18790 )

* fix(orchestration): remint live handle from process incarnation on worker release

When a durable terminal handle goes stale (rendererGraphEpoch fence),
inspectWorkerTerminal re-mints a live handle via
resolveTerminalHandleByProcessIncarnation + matchesProcessIncarnation so
release/stop/read act on the still-running PTY instead of reporting
missing and leaking the agent process tree.

- keep main shared host-scope re-exports; add matchesProcessIncarnation
- wire observation.terminalHandle through control/stop/release
- rebuild release-completion on main structured paths
- on missing/unattached + provably exited: settleDead fence first, then
  same-incarnation settleWorker fall back (archive may block settleDead
  mid-request); settle before recovery defer

* fix(orchestration): derive SSH host scope from the reminted handle; reuse fresh-request recovery guidance for structured workers

Addresses two open CodeRabbit review comments on PR #18790.

inspectWorkerTerminal read the dispatch authority with the stale durable
terminalHandle, so after a remint the lookup resolved nowhere and
currentHostScope was always undefined — an SSH worker with no liveness
verdict and no persisted host_scope got classified from terminal.connected
instead of unverifiable. It now reads the same effectiveHandle every other
observation in the function uses.

stopStructuredWorkerForRelease told the caller to repeat the release with
the same --retry-request, which only replays the stale release_unknown
receipt and made a structured-worker close failure permanently unretryable.
It now sources releaseUnknownRecovery from worker-release-completion so the
fresh-request-ID guidance lives in one place.

Pre-commit lint-staged (oxlint + oxfmt) run manually: clean.

* test(orchestration): exercise incarnation recovery through runtime paths

* test(orchestration): pin the incarnation read scenario to the reminted terminal

The read scenario only asserted that the call resolved, so it documented
nothing about which handle the read reached. Assert that the handle
readTerminal received resolves to the registered pane and incarnation, so
the scenario proves the read went through the reminted terminal instead of
passing on the incarnation fence's throw.

* refactor(orchestration): drop redundant incarnation prefix check; require liveTerminalHandle

* feat: add freebuff as a first-class TUI agent (#42)

<!-- orca-pr-loc -->
<!-- Programmatic LoC summary. Do not edit by hand; rewritten on every
commit. -->

| | Files | Added | Deleted | Net |
| :--- | ---: | ---: | ---: | ---: |
| Test | 0 | 0 | 0 | 0 |
| Prod | 28 | $\color{#1a7f37}{\Huge{\mathbf{+}}}$37 | 0 |
$\color{#1a7f37}{\Huge{\mathbf{+}}}$37 |

<!-- /orca-pr-loc -->

## ELI5

Add Freebuff (`freebuff`) as a recognized first-class TUI coding agent
in Orca alongside Codebuff and other supported agents.

## What Changed

- Registered `freebuff` across shared TUI agent definitions,
configuration catalogs, display names, and telemetry schemas.
- Added agent icons, favicons, status mappings, and mobile asset
references for Freebuff.
- Added localization strings across supported language packs (`en`,
`es`, `fr`, `ja`, `ko`, `zh`) and updated locale translation policy.
- Documented Freebuff CLI in README agent table (`npm i -g freebuff`).

## Why

Freebuff is a CLI coding agent twin of Codebuff (`npm i -g freebuff`).
Adding it to the catalog enables users to launch worktrees, run
automated sessions, and pick Freebuff directly within Orca.

## Linked Issue

N/A

## Visual Proof

`N/A` - Catalog registration and metadata definition for CLI agent
launch; UI rendering uses existing TUI agent picker and status
components.

## Testing

- Verified TypeScript contracts, schemas, and catalog configurations.
- Tested CLI detection / agent picker integration locally on Linux
(`worktree create --agent freebuff`).

## AI Disclosure

Assisted by AI coding tooling.

## Checklist

- [x] This PR is small and focused
- [x] I explained what changed and why (including ELI5)
- [x] Before/after screenshots or videos attached for UI changes, or
`N/A` with reason
- [x] Self-reviewed for correctness, security, and performance
- [x] Cross-platform, SSH/remote, and path/shortcut impact considered
(or N/A)

---------

Co-authored-by: Lesley Murfin <lesley@revivebusiness.ca>

* test(orchestration): erase method overloads in worker reap fixtures

* test: document worker fixture type boundaries

* test: simplify worker fixture typing

---------

Co-authored-by: Neil <4138956+nwparker@users.noreply.github.com>
Co-authored-by: svc-orca[bot] <313947298+svc-orca[bot]@users.noreply.github.com>
Co-authored-by: m4air <m4air@Mac.localdomain>

2026-09-21 17:23:33 -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.48 · 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 OpenCode MiMo Code Amp OpenClaude Antigravity Pi oh-my-pi Hermes Agent Devin Goose Auggie Autohand Code Charm Cline Codebuff Freebuff 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.48

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 9 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