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

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 OpenCode Amp OpenClaude Antigravity Pi oh-my-pi Hermes Agent Goose Auggie Autohand Code Charm Cline Codebuff Freebuff 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