orca/docs
Jinjing 90d0fae8f5
feat: add explicit worktree setup flow (#286)
* feat: add explicit worktree setup flow

- Centralize worktree activation setup flow

- fix: render orca.yaml file contents in settings repo pane instead of tags when using config file

- fix: command preview title for yaml configs

- fix: update UI copy and styling to better reflect yaml setup hooks

- fix: run setup hook in background if CLI worktree is created while GUI is closed

- fix: prevent duplicate terminal tab creation when creating worktrees from the UI

- fix: ensure CLI worktree create returns correct payload type and hooks up UI setup flow

- Squashed commits

- fix minor regression

- fix: close worktree context menu when deleting

- fix: keep delete dialog open while archive hook runs and support inline yaml scripts

- chore: fix lint, typecheck and react state mutations during render for setup script feature

* fix(lint): split worktrees.test.ts to stay under max-lines limit

Extract Windows path-handling tests into worktrees-windows.test.ts
to bring the original file under the 300-line oxlint max-lines rule.

* fix(test): set up path mocks for setup launch payload test

The computeWorktreePathMock and ensurePathWithinWorkspaceMock were
cleared by afterEach but not re-established in the test, causing
areWorktreePathsEqual to receive undefined and crash.
2026-04-03 23:44:23 -07:00
..
README.md Add Orca runtime CLI and bundled install support (#273) 2026-04-03 16:50:28 -07:00
orca-cli-bundled-distribution.md Add Orca runtime CLI and bundled install support (#273) 2026-04-03 16:50:28 -07:00
orca-cli-focused-v1-status.md Add Orca runtime CLI and bundled install support (#273) 2026-04-03 16:50:28 -07:00
orca-cli-v1-spec.md Add Orca runtime CLI and bundled install support (#273) 2026-04-03 16:50:28 -07:00
orca-runtime-layer-design.md Add Orca runtime CLI and bundled install support (#273) 2026-04-03 16:50:28 -07:00
right-sidebar-conflict-resolution-status.md feat: show merge conflicts in source control sidebar (#204) 2026-03-29 15:40:23 -07:00
source-control-branch-diff-design.md Show committed files in the "source control" tab (#181) 2026-03-28 17:00:40 -07:00
worktree-setup-script-design-review.md feat: add explicit worktree setup flow (#286) 2026-04-03 23:44:23 -07:00
worktree-setup-script-design.md feat: add explicit worktree setup flow (#286) 2026-04-03 23:44:23 -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.