Repository navigation
Releases: okikorg/orca-harness
Release list
orcacode v0.8.0
Orcacode 0.8.0 refreshes the terminal interface, simplifies the default tools, preserves images returned by tools, and discovers the latest Codex models.
Highlights
- Refreshed terminal components, split pane tabs, and mark and branch settings.
- Codex catalog compatibility updated to 0.159.2, making
gpt-6.1-solavailable when enabled for your account. - Images returned by tools reach the model as images, with their order and labels preserved per call.
Tool changes
edit_filehandles either one{path, old, new}edit or an ordered, transactionaleditsbatch across files. It replacesmulti_editandapply_patch.globandshellcover directory listing;list_diris removed.web_searchandweb_fetchremain;web_crawlis removed.- Interactive plan mode allows shell commands with a yes/no approval for every command. Headless plan mode and workers continue to deny shell access.
- Update custom tool allowlists that reference the removed tools.
Documentation
- Updated external manual, measured startup latency, and five-harness comparisons.
- Added contribution guidelines and a harness-core patch folder.
Install
macOS / Linux:
curl -fsSL https://orcapods.ai/orcacode.sh | shWindows (PowerShell):
irm https://orcapods.ai/orcacode.ps1 | iexAssets
| Asset | Platform |
|---|---|
| orcacode-darwin-arm64.tar.gz | macOS, Apple Silicon |
| orcacode-darwin-x64.tar.gz | macOS, Intel |
| orcacode-linux-x64.tar.gz | Linux x64, static musl |
| orcacode-linux-arm64.tar.gz | Linux arm64, static musl |
| orcacode-windows-x64.zip | Windows x64 |
Verify downloads against SHA256SUMS.
Full changelog: orcacode-v0.7.0...orcacode-v0.8.0
orcacode v0.7.0
Orcacode's first public release: the source is now open under the Apache License 2.0. It also adds orchestrate mode, persistent sidekick agents, and a much larger Rust SDK.
Open source
- Orcacode and Orca Harness are now licensed under the Apache License 2.0 (
LICENSE,NOTICE). Earlier releases were proprietary. - New README, screenshots, and a refreshed field manual at https://orcapods.ai/orcacode/docs/.
Highlights
- Orchestrate mode (
/mode orchestrate,--orchestrate): the parent investigates, makes basic edits, and delegates substantial work to subagents and workflows. - Sidekicks: session-long workers that keep their context between follow-up tasks (
/sidekick <task>,/sidekick stop, orpersistent: trueon thesubagenttool). They survive model and provider switches and stop on/clear, session load and exit. - After plan mode writes a plan, Orcacode asks whether to approve it and start implementing.
- MCP servers connect in the background, so startup no longer waits on them.
- Resume a session by ID from any workspace (
orcacode resume ID). - Provider failures are shown as readable text instead of raw JSON.
- The Codex provider requests catalog client version 0.155.1, which lists gpt-6-sol and gpt-6-luna.
Rust SDK
Agent::runone-shot convenience, and groupedcontracts,providers,orchestrationandintegrationsnamespaces.- Session-owned tool state, context import, run continuation, caller cancellation, and partial run outcomes.
- Typed subagent, background process and workflow operations, shared with the model-facing tools, with session-owned delivery and shutdown.
- Per-run MCP tool capture and skill refresh, owned skill previews, and classified tool and model retries.
Fixes
- Stream chunks that send
nullfor a list (seen from CheaperInference) no longer fail the run with a "bad stream chunk" error. - Headless text output no longer runs answer text, reasoning and tool rows together on one line.
- Worker budgets are preserved and orchestration telemetry is exposed.
- Only live processes count against the process spawn cap.
- Background completions are announced reliably at run end and after an inbox reset.
Install
macOS / Linux:
curl -fsSL https://orcapods.ai/orcacode.sh | shWindows (PowerShell):
irm https://orcapods.ai/orcacode.ps1 | iexAssets
| Asset | Platform |
|---|---|
| orcacode-darwin-arm64.tar.gz | macOS, Apple Silicon |
| orcacode-darwin-x64.tar.gz | macOS, Intel |
| orcacode-linux-x64.tar.gz | Linux x64, static musl |
| orcacode-linux-arm64.tar.gz | Linux arm64, static musl |
| orcacode-windows-x64.zip | Windows x64 |
Verify downloads against SHA256SUMS.
Full changelog: orcacode-v0.6.2...orcacode-v0.7.0
orcacode v0.6.2
A native Anthropic Messages API provider, plus token-accounting fixes for OpenRouter cache writes and the TUI.
Highlights
- native Anthropic Messages API provider (#22)
Fixes
- stop double-counting OpenRouter cache writes into input_tokens (#20)
- remove separate thinking token count
Other changes
- pin the Rust toolchain to 1.98.1 (#21)
- correct the license metadata: the project is proprietary, not MIT (LICENSE added)
Install
macOS / Linux:
curl -fsSL https://orcapods.ai/orcacode.sh | shWindows (PowerShell):
irm https://orcapods.ai/orcacode.ps1 | iexAssets
| Asset | Platform |
|---|---|
| orcacode-darwin-arm64.tar.gz | macOS, Apple Silicon |
| orcacode-darwin-x64.tar.gz | macOS, Intel |
| orcacode-linux-x64.tar.gz | Linux x64, static musl |
| orcacode-linux-arm64.tar.gz | Linux arm64, static musl |
| orcacode-windows-x64.zip | Windows x64 |
Verify downloads against SHA256SUMS.
Full changelog: orcacode-v0.6.1...orcacode-v0.6.2
orcacode v0.6.1
Streaming responses reuse rendered Markdown and batch incoming updates, keeping the TUI responsive to typing, cancellation, and approvals. This release also includes the provider and status improvements prepared for 0.6.0.
Performance
- Cache unchanged streaming Markdown across keyboard, scrolling, and animation frames. Text, terminal width, theme, and glyph changes invalidate the cache.
- Coalesce worker updates into scheduled redraws, with bounded batches and priority for keyboard input and approval prompts.
- Reduce repeated work in workflow scheduling and provider request construction.
- Tighten startup and add benchmark coverage.
Highlights
- Add CheaperInference as a configurable provider.
- Give the glyph status bar dedicated marks and show streamed token estimates alongside run progress.
Fixes
- Preserve the underlying cause of provider transport failures.
- Trust the system certificate store alongside bundled certificate roots.
- Expand coverage for provider streaming, workflow contracts, and TUI event ordering.
Install
macOS / Linux:
curl -fsSL https://orcapods.ai/orcacode.sh | shWindows (PowerShell):
irm https://orcapods.ai/orcacode.ps1 | iexAssets
| Asset | Platform |
|---|---|
| orcacode-darwin-arm64.tar.gz | macOS, Apple Silicon |
| orcacode-darwin-x64.tar.gz | macOS, Intel |
| orcacode-linux-x64.tar.gz | Linux x64, static musl |
| orcacode-linux-arm64.tar.gz | Linux arm64, static musl |
| orcacode-windows-x64.zip | Windows x64 |
Verify downloads against SHA256SUMS.
Full changelog: orcacode-v0.5.0...orcacode-v0.6.1
orcacode v0.5.0
A terminal-UI pass for the orcacode CLI: inline !cmd shell output, a compact agent view with per-subagent model selection, refined provider model selection, and skills that load once per conversation.
Highlights
- show !cmd shell output inline after it finishes
- configure subagent models and compact agent UI
- refine terminal UI and provider model selection
- load a skill once per conversation
Other changes
- centralize tool activity labels
Install
macOS / Linux:
curl -fsSL https://orcapods.ai/orcacode.sh | shWindows (PowerShell):
irm https://orcapods.ai/orcacode.ps1 | iexAssets
| Asset | Platform |
|---|---|
| orcacode-darwin-arm64.tar.gz | macOS, Apple Silicon |
| orcacode-darwin-x64.tar.gz | macOS, Intel |
| orcacode-linux-x64.tar.gz | Linux x64, static musl |
| orcacode-linux-arm64.tar.gz | Linux arm64, static musl |
| orcacode-windows-x64.zip | Windows x64 |
Verify downloads against SHA256SUMS.
Full changelog: orcacode-v0.4.0...orcacode-v0.5.0
orcacode v0.4.0
This release lets subagents run in the background and gives you control over which models they use.
Highlights
- Subagents can run detached in the background. A completion inbox wakes the parent when one finishes, and the TUI gains an agent browser with tabs for switching between them.
/subagentsis now a live settings panel shared across the parent and workers and persisted to config. It includes a background concurrency limit and model routing per subagent: inherit, auto, a preferred model, or a tier.- Model gates admit or hold requests per model, and the OpenAI and Codex providers honour
Retry-Afterand classify HTTP errors so retries are driven by the server's guidance rather than a fixed backoff.
Fixes
- The
/subagentsroute and preferred models survive agent rebuilds (/clear,/model,/provider, config reloads) instead of resetting to defaults.
Install
macOS / Linux:
curl -fsSL https://orcapods.ai/orcacode.sh | shWindows (PowerShell):
irm https://orcapods.ai/orcacode.ps1 | iexAssets
| Asset | Platform |
|---|---|
| orcacode-darwin-arm64.tar.gz | macOS, Apple Silicon |
| orcacode-darwin-x64.tar.gz | macOS, Intel |
| orcacode-linux-x64.tar.gz | Linux x64, static musl |
| orcacode-linux-arm64.tar.gz | Linux arm64, static musl |
| orcacode-windows-x64.zip | Windows x64 |
Verify downloads against SHA256SUMS.
Full changelog: orcacode-v0.3.0...orcacode-v0.4.0
orcacode v0.3.0
This release makes long-running process work more efficient and keeps release changes easy to inspect inside Orcacode.
Highlights
- Detached processes can wake the interactive agent when they exit or when a one-shot literal output match appears.
- Finite long-running commands can use
waitForExitto return once at completion instead of requiring repeated polling. /changelogshows the latest release changes, while/changelog fullshows the full bundled history.- Orcacode reports when an update is available at startup.
Fixes
- Background-process notifications are generation-scoped so stale processes cannot resume a replaced or cleared conversation.
- Process output already returned by a tool call is not repeated in later notifications.
- Explicit process termination does not generate a duplicate exit notification.
Install
macOS / Linux:
curl -fsSL https://orcapods.ai/orcacode.sh | shWindows (PowerShell):
irm https://orcapods.ai/orcacode.ps1 | iexAssets
| Asset | Platform |
|---|---|
| orcacode-darwin-arm64.tar.gz | macOS, Apple Silicon |
| orcacode-darwin-x64.tar.gz | macOS, Intel |
| orcacode-linux-x64.tar.gz | Linux x64, static musl |
| orcacode-linux-arm64.tar.gz | Linux arm64, static musl |
| orcacode-windows-x64.zip | Windows x64 |
Verify downloads against SHA256SUMS.
Full changelog: orcacode-v0.2.2...orcacode-v0.3.0
orcacode v0.2.2
This release adds a self-update command and a lowercase short version flag.
Highlights
- add self-update command (#10)
Install
macOS / Linux:
curl -fsSL https://orcapods.ai/orcacode.sh | shWindows (PowerShell):
irm https://orcapods.ai/orcacode.ps1 | iexAssets
| Asset | Platform |
|---|---|
| orcacode-darwin-arm64.tar.gz | macOS, Apple Silicon |
| orcacode-darwin-x64.tar.gz | macOS, Intel |
| orcacode-linux-x64.tar.gz | Linux x64, static musl |
| orcacode-linux-arm64.tar.gz | Linux arm64, static musl |
| orcacode-windows-x64.zip | Windows x64 |
Verify downloads against SHA256SUMS.
Full changelog: orcacode-v0.2.1...orcacode-v0.2.2
orcacode v0.2.1
This release improves terminal responsiveness and status visibility, removes the default shell-command timeout, and simplifies syntax highlighting dependencies.
Highlights
- lead the status-bar model with its provider
Fixes
Performance
- trim the dispatcher fast path and skill discovery syscalls (#5)
Other changes
- release commands, checked-in release notes, notes as the release body (#4)
Install
macOS / Linux:
curl -fsSL https://orcapods.ai/orcacode.sh | shWindows (PowerShell):
irm https://orcapods.ai/orcacode.ps1 | iexAssets
| Asset | Platform |
|---|---|
| orcacode-darwin-arm64.tar.gz | macOS, Apple Silicon |
| orcacode-darwin-x64.tar.gz | macOS, Intel |
| orcacode-linux-x64.tar.gz | Linux x64, static musl |
| orcacode-linux-arm64.tar.gz | Linux arm64, static musl |
| orcacode-windows-x64.zip | Windows x64 |
Verify downloads against SHA256SUMS.
Full changelog: orcacode-v0.2.0...orcacode-v0.2.1
orcacode v0.2.0
The second binary release of orcacode, the terminal host for Orca Harness. Built from this tag with the release profile (fat LTO, stripped); single static executables.
Highlights
- Vercel AI Gateway as a first-class provider. Point orcacode at
ai-gateway.vercel.shwithAI_GATEWAY_API_KEY;--provider vercelor/providerin the TUI. - File mutation tooling. Core write, edit, and patch tools with a unified patch format and an approval workflow, including a default auto-approval mode.
- Subagents. Routing preferences are enforced when a task fans out to a subagent.
- TUI. Clipboard image paste, a wrapping composer with a stacked split and anchored live region, a priority-dropping status bar, an approval prompt, glyph styles, and inline mermaid rendering.
- Robustness. Truncated OpenAI tool calls are handled, and routine auto shell checks are faster.
Install
macOS / Linux:
curl -fsSL https://orcapods.ai/orcacode.sh | shWindows (PowerShell):
irm https://orcapods.ai/orcacode.ps1 | iexAssets
| Asset | Platform |
|---|---|
| orcacode-darwin-arm64.tar.gz | macOS, Apple Silicon |
| orcacode-darwin-x64.tar.gz | macOS, Intel |
| orcacode-linux-x64.tar.gz | Linux x64, static musl |
| orcacode-linux-arm64.tar.gz | Linux arm64, static musl |
| orcacode-windows-x64.zip | Windows x64 |
Verify downloads against SHA256SUMS.
Full changelog: orcacode-v0.1.0...orcacode-v0.2.0