BingZandNeil 09dd95d632 docs(cli): document terminal read --json result fields and cursor roles (#13173) ...

`orca terminal read --help` listed flags but not the --json result shape,
so agents guessed field names and paged with latestCursor instead of
nextCursor. Add Notes listing result.terminal fields, the meaning of
truncated vs limited, when nextCursor is null, and how to page with
nextCursor/oldestCursor.

Fixes #7433

Co-authored-by: Neil <neil@stably.ai>

2026-10-27 23:46:57 -07:00

..

handlers

fix(runtime): add opt-in agentWait to worktree ps agent rows (#24142)

2026-10-27 20:46:00 -07:00

runtime

fix(orcad): materialize the app's agent-browser driver into the local slot (#34150)

2026-10-27 01:28:20 -07:00

specs

docs(cli): document terminal read --json result fields and cursor roles (#13173)

2026-10-27 23:46:57 -07:00

agent-context.test.ts

test: audit CLI output and deferred delivery boundaries (#32498)

2026-10-23 06:36:47 -07:00

agent-context.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

agent-launch-process.test.ts

A launch can name chat or terminal: agent.launch gets a surface pick and the CLI gets --surface chat|terminal (#31191)

2026-10-20 16:45:05 -07:00

agent-launch-recovery.ts

fix(cli): honor Chat UI setting for worktree agent creation (#27796)

2026-10-12 02:14:43 -07:00

agent-launch-request.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

agent-launch-test-fixtures.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

agent-session-search-format.test.ts

fix(cli): strip terminal control sequences from Linear text in CLI output (#31677)

2026-10-27 20:30:08 -07:00

agent-session-search-format.ts

fix(cli): strip terminal control sequences from Linear text in CLI output (#31677)

2026-10-27 20:30:08 -07:00

agent-workspace-selector.ts

feat(cli): launch agents in existing workspaces (#27794)

2026-10-12 00:38:00 -07:00

args-repeatable-flags.test.ts

feat(cli): orca search over the agent session index (#20514)

2026-09-16 12:03:38 -04:00

args.test.ts

fix(cli): help lists only the flags each command actually takes (#34598)

2026-10-27 16:06:49 -07:00

args.ts

fix(cli): show help for bare command groups (#34502)

2026-10-27 21:12:11 -07:00

artifact-format.ts

Add account-backed artifact sharing (#13012)

2026-08-07 23:02:29 -07:00

automation-destination.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

automation-format.test.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

automation-format.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

automation-owner-conflict-recovery.test.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

automation-owner-conflict-recovery.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

automation-runs-paging.test.ts

refactor: group remote runtime client modules (#34133)

2026-10-26 17:47:25 -07:00

automation-runs-paging.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

base64-payload-byte-count.ts

Harden computer use runtime and CLI (#4705)

2026-06-07 17:49:01 -07:00

browser-empty-values.test.ts

fix(browser): accept an empty --value in fill and select commands (#16030)

2026-10-26 03:27:29 -07:00

browser-format.ts

fix(browser): make the browser identity one process-wide choice (#13822) (#20767)

2026-09-16 10:31:01 -07:00

browser-handler-groups.ts

feat(browser): show agent browsing live, with a jump to the page from chat (#33075)

2026-10-25 22:15:00 +00:00

browser.test.ts

fix(browser): pass orca wait's timeout through to agent-browser (#34283)

2026-10-27 06:17:21 +00:00

bundled-skill-guides.ts

docs(cli): explain automation prechecks and folder workspace removal (#34523)

2026-10-27 21:13:03 -07:00

caller-host-worktree-selection.ts

fix(cli): resolve folder workspace terminals to their own workspace (#33703)

2026-10-26 20:12:36 +00:00

cli-error.ts

fix(cli): preserve runtime recovery steps (#24800)

2026-10-23 19:20:30 -07:00

cli-version.test.ts

Update Orca's skills with Orca's own installer instead of npx skills (#31688)

2026-10-22 22:35:14 -04:00

cli-version.ts

Update Orca's skills with Orca's own installer instead of npx skills (#31688)

2026-10-22 22:35:14 -04:00

codex-command-classification.test.ts

fix(terminal): run Codex in Orca terminals without the shared background server (#23900)

2026-09-29 10:22:27 -07:00

codex-command-classification.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

command-body-input.ts

feat(cli): let agents read and update Jira tickets safely (#28592)

2026-10-14 03:03:50 -07:00

command-scoped-flag-help.ts

fix(orchestration): preserve task reset lineage per Run (#28823)

2026-10-26 14:05:33 -07:00

command-spec.ts

fix(cli): help lists only the flags each command actually takes (#34598)

2026-10-27 16:06:49 -07:00

command-suggestion-budget.test.ts

fix(cli): preserve alias recovery while guarding destructive suggestions (#26934)

2026-10-10 15:16:18 -07:00

command-suggestion-destructive-families.test.ts

test: audit CLI output and deferred delivery boundaries (#32498)

2026-10-23 06:36:47 -07:00

command-suggestion.test.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

command-suggestion.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

computer-format.test.ts

fix(cli): preserve primitive success results in JSON output

2026-10-03 00:50:46 -07:00

computer-format.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

dispatch.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

emulator-logcat-format.test.ts

feat(emulator): Android emulation via scrcpy (cross-platform, iOS parity) (#6434)

2026-06-28 21:01:09 -07:00

emulator-logcat-format.ts

feat(emulator): Android emulation via scrcpy (cross-platform, iOS parity) (#6434)

2026-06-28 21:01:09 -07:00

emulator-permissions-args.ts

feat(emulator): Android emulation via scrcpy (cross-platform, iOS parity) (#6434)

2026-06-28 21:01:09 -07:00

execution-host-flag.test.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

execution-host-flag.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

flag-help-text.ts

fix(runtime): add opt-in agentWait to worktree ps agent rows (#24142)

2026-10-27 20:46:00 -07:00

flags.ts

fix(cli): reject empty --terminal/--from handles instead of falling back to defaults (#16745)

2026-10-26 06:30:34 -07:00

format-recovery.test.ts

fix(cli): preserve runtime recovery steps (#24800)

2026-10-23 19:20:30 -07:00

format.test.ts

test: audit CLI dispatch and mobile host boundaries (#32576)

2026-10-23 07:34:51 -07:00

format.ts

[comment audit] Shorten CLI parsing and host-routing comments (#32265)

2026-10-23 07:49:36 -07:00

handler-group-manifest.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

handler-group-manifest.ts

feat(connector): Slack-started agents can reply in their thread (orca connector reply, local only) (#33855)

2026-10-26 18:55:05 -04:00

help.ts

fix(cli): help lists only the flags each command actually takes (#34598)

2026-10-27 16:06:49 -07:00

host-selector-alternatives.test.ts

test: strengthen CLI, lifecycle, bundle and build coverage (audit 8) (#32777)

2026-10-23 11:06:37 -07:00

host-selector-alternatives.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

index-agent-launch.test.ts

test: strengthen CLI, lifecycle, bundle and build coverage (audit 8) (#32777)

2026-10-23 11:06:37 -07:00

index-automation-extra-agent-args.test.ts

test: strengthen CLI, lifecycle, bundle and build coverage (audit 8) (#32777)

2026-10-23 11:06:37 -07:00

index-automation-identifiers.test.ts

test: strengthen CLI, lifecycle, bundle and build coverage (audit 8) (#32777)

2026-10-23 11:06:37 -07:00

index-automation-run-output.test.ts

test: strengthen CLI, lifecycle, bundle and build coverage (audit 8) (#32777)

2026-10-23 11:06:37 -07:00

index-automation-schedule.test.ts

test: strengthen CLI, lifecycle, bundle and build coverage (audit 8) (#32777)

2026-10-23 11:06:37 -07:00

index-automation-session-reuse.test.ts

test: strengthen CLI, lifecycle, bundle and build coverage (audit 8) (#32777)

2026-10-23 11:06:37 -07:00

index-automation-source-context.test.ts

test: strengthen CLI, lifecycle, bundle and build coverage (audit 8) (#32777)

2026-10-23 11:06:37 -07:00

index-automation-target.test.ts

test: strengthen CLI, lifecycle, bundle and build coverage (audit 8) (#32777)

2026-10-23 11:06:37 -07:00

index-device-commands.test.ts

test: strengthen hook delivery, CLI and mobile shell coverage (audit 9) (#32876)

2026-10-23 12:04:06 -07:00

index-environment-commands.test.ts

test: strengthen hook delivery, CLI and mobile shell coverage (audit 9) (#32876)

2026-10-23 12:04:06 -07:00

index-file-open-headless.test.ts

test: strengthen hook delivery, CLI and mobile shell coverage (audit 9) (#32876)

2026-10-23 12:04:06 -07:00

index-jira.test.ts

refactor(jira): colocate shared contracts and capabilities (#32927)

2026-10-23 14:31:05 -07:00

index-local-command-routing-flags.test.ts

test: strengthen hook delivery, CLI and mobile shell coverage (audit 9) (#32876)

2026-10-23 12:04:06 -07:00

index-memory-diagnostics.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

index-omitted-host-scope-selectors.test.ts

test: strengthen hook delivery, CLI and mobile shell coverage (audit 9) (#32876)

2026-10-23 12:04:06 -07:00

index-orchestration.test.ts

test: strengthen hook delivery, CLI and mobile shell coverage (audit 9) (#32876)

2026-10-23 12:04:06 -07:00

index-ports.test.ts

feat(cli): add orca ports to list a workspace's detected ports (#33016)

2026-10-23 20:05:47 -07:00

index-project-name-selectors.test.ts

test: strengthen hook delivery, CLI and mobile shell coverage (audit 9) (#32876)

2026-10-23 12:04:06 -07:00

index-project-setup.test.ts

test: strengthen hook delivery, CLI and mobile shell coverage (audit 9) (#32876)

2026-10-23 12:04:06 -07:00

index-reference-jira.test.ts

test: strengthen CLI expectations and consolidate repeated scenarios (#32976)

2026-10-23 17:11:16 -07:00

index-reference.test.ts

test: strengthen CLI expectations and consolidate repeated scenarios (#32976)

2026-10-23 17:11:16 -07:00

index-serve-command.test.ts

test: strengthen CLI expectations and consolidate repeated scenarios (#32976)

2026-10-23 17:11:16 -07:00

index-serve-restore.test.ts

test: strengthen CLI expectations and consolidate repeated scenarios (#32976)

2026-10-23 17:11:16 -07:00

index-terminal-commands.test.ts

fix(cli): reject empty --terminal/--from handles instead of falling back to defaults (#16745)

2026-10-26 06:30:34 -07:00

index-terminal-list-host-scope.test.ts

test: strengthen CLI expectations and consolidate repeated scenarios (#32976)

2026-10-23 17:11:16 -07:00

index-test-harness.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

index-vm-recipe-doctor.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

index-worktree-create-agent.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

index-worktree-create-host-scoped-repo.test.ts

fix(cli): infer the repo for worktree create when the parent is host-scoped by identity (#29909)

2026-10-16 19:02:47 -07:00

index-worktree-create-linear.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

index-worktree-create-parent.test.ts

Preserve user-set workspace names across branch changes (#17448)

2026-08-31 19:08:05 -04:00

index-worktree-create-repo-host.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

index-worktree-create-target.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

index-worktree-gitlab-links.test.ts

test: repair CLI and mobile fixtures and remove duplicate checks (#33518)

2026-10-25 04:50:21 -07:00

index-worktree-linked-items.test.ts

test: repair CLI and mobile fixtures and remove duplicate checks (#33518)

2026-10-25 04:50:21 -07:00

index-worktree-selector-resolution.test.ts

test: repair CLI and mobile fixtures and remove duplicate checks (#33518)

2026-10-25 04:50:21 -07:00

index-worktree-set.test.ts

test: repair CLI and mobile fixtures and remove duplicate checks (#33518)

2026-10-25 04:50:21 -07:00

index.test.ts

fix(cli): show help for bare command groups (#34502)

2026-10-27 21:12:11 -07:00

index.ts

fix(cli): show help for bare command groups (#34502)

2026-10-27 21:12:11 -07:00

jira-format.ts

refactor(jira): colocate shared contracts and capabilities (#32927)

2026-10-23 14:31:05 -07:00

jira-handler-group.ts

feat(cli): let agents read and update Jira tickets safely (#28592)

2026-10-14 03:03:50 -07:00

jira-target.ts

refactor(shared): colocate Jira rules and direct imports (#33164)

2026-10-24 06:46:07 -07:00

linear-format.test.ts

fix(cli): strip terminal control sequences from Linear text in CLI output (#31677)

2026-10-27 20:30:08 -07:00

linear-format.ts

fix(cli): strip terminal control sequences from Linear text in CLI output (#31677)

2026-10-27 20:30:08 -07:00

linear-handler-group.ts

feat(linear): edit and delete Linear comments from the CLI (#30003)

2026-10-17 13:14:48 -07:00

linear-request-builders.ts

fix: keep identifier casing locale-independent (Turkish) (#34709)

2026-10-27 22:47:01 -07:00

linear-save-issue-request.ts

refactor(shared): group worktree, github, and linear modules into folders (#14437)

2026-08-13 20:44:16 -07:00

omitted-host-scope-selectors.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

orchestration-dispatch-refusal-format.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

orchestration-mutation-recovery.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

orchestration-mutation-recovery.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

orchestration-session-caller-cli.test.ts

test: strengthen CLI and mobile behavior checks (#33526)

2026-10-25 05:16:25 -07:00

orchestration-structured-sender-identity.test.ts

test: consolidate duplicates and strengthen behavioral boundaries (#33088)

2026-10-24 01:22:18 -07:00

orchestration-structured-session-no-identity.test.ts

test: consolidate duplicates and strengthen behavioral boundaries (#33088)

2026-10-24 01:22:18 -07:00

paired-terminal-desktop-reveal.test.ts

test: remove redundant checks and strengthen runtime assertions (#33498)

2026-10-25 03:20:18 -07:00

paired-terminal-desktop-reveal.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

ports-format.ts

feat(cli): add orca ports to list a workspace's detected ports (#33016)

2026-10-23 20:05:47 -07:00

profile-state-location.ts

Persist profile state in SQLite with background writes (#22612)

2026-09-25 22:47:33 -07:00

project-format.ts

refactor(shared): drop the shared/types barrel and import from the real modules (#14447)

2026-08-13 22:48:24 -07:00

project-selector.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

quote-stripped-json-flag.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

quote-stripped-json-flag.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

reference-command-arguments.test.ts

Add CLI commands to manage and find workspace references (#26807)

2026-10-09 22:22:01 -07:00

reference-handler-group.ts

feat(cli): let agents read and update Jira tickets safely (#28592)

2026-10-14 03:03:50 -07:00

reference-input.ts

refactor(shared): colocate Jira rules and direct imports (#33164)

2026-10-24 06:46:07 -07:00

remote-selection-flag-rejection.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

remote-selection-scope.ts

fix(cli): help lists only the flags each command actually takes (#34598)

2026-10-27 16:06:49 -07:00

repo-path-arguments.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

retry-request-flag.test.ts

feat(orchestration): make multi-agent workflows durable (#16904)

2026-09-06 14:34:03 -04:00

retry-request-flag.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

root-help-text-primary.ts

Stop workers from taking over the Run they work for (#29008)

2026-10-26 00:46:27 -07:00

root-help-text-secondary.ts

fix(runtime): add opt-in agentWait to worktree ps agent rows (#24142)

2026-10-27 20:46:00 -07:00

runtime-client-deferral.test.ts

test: remove redundant checks and strengthen runtime assertions (#33498)

2026-10-25 03:20:18 -07:00

runtime-client.test.ts

test: strengthen CLI and mobile behavior checks (#33526)

2026-10-25 05:16:25 -07:00

runtime-client.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

search-command-arguments.test.ts

test: consolidate redundant checks and strengthen boundary coverage (#33082)

2026-10-24 00:57:20 -07:00

search-command-arguments.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

selector-ambiguity-recovery.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

selectors.ts

fix(cli): resolve folder workspace terminals to their own workspace (#33703)

2026-10-26 20:12:36 +00:00

serve-electron-flag-parity.test.ts

fix(orcad): add --reclaim-stale-lock for a lock no start can judge after a reboot on a shared home (#32915)

2026-10-23 15:26:03 -07:00

session-caller-flags.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

shell-command-quote.test.ts

Harden computer use runtime and CLI (#4705)

2026-06-07 17:49:01 -07:00

shell-command-quote.ts

refactor(shell): one shell-argument-quoting module for the duplicated quote copies (#30564)

2026-10-18 23:12:27 -07:00

skills-cli-agent-aliases.test.ts

Update Orca's skills with Orca's own installer instead of npx skills (#31688)

2026-10-22 22:35:14 -04:00

skills-cli-agent-aliases.ts

Update Orca's skills with Orca's own installer instead of npx skills (#31688)

2026-10-22 22:35:14 -04:00

skills-install.test.ts

test: strengthen CLI and mobile behavior checks (#33526)

2026-10-25 05:16:25 -07:00

skills-reference-selector.test.ts

Show Orca publishing guidance only when the host has it on (STA-12225) (#34547)

2026-10-27 18:20:40 -04:00

skills.test.ts

Show Orca publishing guidance only when the host has it on (STA-12225) (#34547)

2026-10-27 18:20:40 -04:00

stdout-line.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

terminal-format.test.ts

fix(cli): show orphaned state in human-readable terminal list/show output (#33910)

2026-10-26 04:01:44 -07:00

terminal-format.ts

fix(cli): show orphaned state in human-readable terminal list/show output (#33910)

2026-10-26 04:01:44 -07:00

terminal-list-host-scope-format.test.ts

fix(cli): show orphaned state in human-readable terminal list/show output (#33910)

2026-10-26 04:01:44 -07:00

terminal-read-screen.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

test-fixtures.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

vocabulary-policy.test.ts

feat(cli): make the CLI self-correcting and self-describing for agents (#6303)

2026-07-10 19:17:01 -07:00

vocabulary-policy.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

workspace-format.ts

fix(memory): show Activity Monitor's footprint in the resource panel on macOS (#33901)

2026-10-26 03:57:41 -07:00

worktree-project-target.ts

fix(cli): reject empty --terminal/--from handles instead of falling back to defaults (#16745)

2026-10-26 06:30:34 -07:00

worktree-ps-program-status.test.ts

feat(agent-status): read OSC 7501 program status beside hooks (#30261)

2026-10-18 22:12:37 -07:00

worktree-ps-program-status.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

worktree-ps-terminal-verdict.test.ts

Phase 3: every SSH host runs a managed Orca server (orcad), replacing the relay (#24863)

2026-10-07 03:15:06 -07:00

worktree-ps-terminal-verdict.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

worktree-selector-caller-host.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00

worktree-selector-recovery.ts

fix(cli): explain unsupported and unresolved worktree parents (#32256)

2026-10-23 13:46:55 -07:00

worktree-selector-wsl-posix-path.test.ts

[comment audit] Shorten remaining CLI root comments (#32273)

2026-10-23 08:07:03 -07:00