Files
orca/docs
brennanb2025andOrca 3d21cd903e feat(smart-sort): title-heuristic fallback for hookless agents
- Per-pane resolution: hook entries authoritative when fresh, terminal-title
  detection fills in for hookless agents (Edge case 9)
- buildAttentionByWorktree threads runtimePaneTitlesByTabId + ptyIdsByTabId
  with tabHasLivePty gate so slept-tab titles don't leak
- buildWorktreeComparator's attentionByWorktree is now non-optional, plus
  NaN/Infinity guards in resolveAttention and history walk
- setRuntimePaneTitle / clearRuntimePaneTitle bump sortEpoch when title
  classification changes so hookless permission prompts re-sort promptly
- Tooltip on Smart sort menu item; PostHog events for class distribution,
  Class 1 promotion (with cause), and smart→recent regression switch

Co-authored-by: Orca <help@stably.ai>
2026-05-11 13:05:41 -07:00
..

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.