orca/docs
Jinjing b501a6faa0
fix(github-drawer): eliminate reopen flash via useSyncExternalStore (#1680)
Replace the setState-driven data flow with useSyncExternalStore so the
drawer reads cached work-item details synchronously on first render.
Warm reopens now paint the cached content immediately with zero blank
flash. Adds a pub/sub layer (subscribeWorkItemDetailsCache /
notifyWorkItemDetailsCache) to all cache-write paths so React is
notified on every touch or invalidation. Includes design doc at
docs/gh-work-item-drawer-cache-flash.md.

Co-authored-by: Orca <help@stably.ai>
2026-05-10 19:53:05 -07:00
..
assets fix(readme): correct Kimi CLI link and swap Anthropic favicon for Claude glyph (#1405) 2026-05-04 13:21:56 -07:00
README.es.md chore: move Autohand Code listing after Auggie in READMEs and agent catalog 2026-05-05 00:27:36 -07:00
README.ja.md chore: move Autohand Code listing after Auggie in READMEs and agent catalog 2026-05-05 00:27:36 -07:00
README.md Revert "fix(skills): remove broken doc references in orca-cli SKILL.md" (#1638) 2026-05-09 18:03:59 -07:00
README.zh-CN.md chore: move Autohand Code listing after Auggie in READMEs and agent catalog 2026-05-05 00:27:36 -07:00
STYLEGUIDE.md Move STYLEGUIDE.md into docs/ (#1625) 2026-05-09 01:08:35 -07:00
gh-work-item-drawer-cache-flash.md fix(github-drawer): eliminate reopen flash via useSyncExternalStore (#1680) 2026-05-10 19:53:05 -07:00
gh-work-item-drawer-cache.md perf(github-drawer): cache work-item details + collapse issue fetch (#1655) 2026-05-09 23:46:30 -07:00
mobile-prefer-renderer-scrollback.md Mobile improvements: scrollback hydration, keyboard layout, and worktree-creation polish (#1423) 2026-05-04 23:24:22 -07:00
mobile-presence-lock.md Mobile: server-authoritative phone-fit state machine + race fixes + UX cleanup (#1518) 2026-05-06 21:54:23 -07:00
mobile-shared-client-per-host.md Mobile: stabilise connection + terminal-fit fixes + share one RpcClient per host (#1481) 2026-05-05 18:58:13 -07:00
resource-usage-merge-spec.md feat(telemetry): PR 4 — wire 7 core events to call sites (#1433) 2026-05-05 11:57:51 -07:00
sidekick-animation-state-mapping.md fix: Support Codex pet sidekick animations (#1533) 2026-05-07 23:50:20 -07:00
tasks-page-resume-state.md feat(tasks): remember tasks page resume state across sessions (#1442) 2026-05-05 11:19:50 -07:00

README.md

Orca CLI Docs

Keep this folder focused on the durable references for Orca's public CLI and runtime model.

Keep These Docs

  • orca-cli-focused-v1-status.md
    • What is actually implemented and intentionally in scope now.
  • orca-cli-v1-spec.md
    • The public CLI contract, selector grammar, JSON envelope, and command semantics.
  • orca-runtime-layer-design.md
    • Why the runtime layer exists and which boundaries it owns.
  • orca-cli-bundled-distribution.md
    • How the bundled desktop-app distribution and PATH registration model works.

Why The Folder Is Small

Earlier design and implementation work produced several planning and evaluation docs. Those were useful while the feature was taking shape, but they were intentionally removed once the implementation converged so future readers are not forced to choose between multiple overlapping sources of truth.