xiaoxue_admin
/
orca
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
orca/docs
History
Neil eb92ba9448
fix(terminal): advertise kitty keyboard protocol for Shift+Enter (#1247) 
Orca's terminal already encodes Shift+Enter as the kitty CSI-u sequence
`\x1b[13;2u`, but without `vtExtensions.kittyKeyboard` xterm.js never
answers the `CSI ? u` probe. CLIs that gate enhanced input on that
handshake (Claude Code, Codex, etc.) therefore drop the extended bytes
and treat Shift+Enter as a plain Enter — most visibly when running
inside tmux, which strips extended-key encodings by default.

- Enable `vtExtensions.kittyKeyboard` in the default terminal options
  (matches VS Code's xtermTerminal).
- Lock in the flag with a regression test in pane-lifecycle.test.ts.
- Add docs/terminal-extended-keys.md explaining the Orca side and the
  tmux-side `set -s extended-keys on` + `terminal-features xterm*:extkeys`
  users need for nested Shift+Enter to reach a CLI.

Verified end-to-end in Electron: `cat -v` + Shift+Enter now prints
`^[[13;2u`, and `printf '\e[?u'` elicits the expected `CSI ? 0 u` reply
from xterm.js.

Co-authored-by: Orca <help@stably.ai>
 		2026-04-28 23:56:29 -07:00
..
assets docs(readme): add Annotate AI Diff feature, SSH support, and Spanish translation (#1080) 2026-04-25 00:01:53 -07:00
design refactor(search): share rg/git-grep logic between main and relay (#1157) 2026-04-27 00:06:00 -07:00
superpowers feat: add .mmd/.mermaid file viewer with rendered diagram toggle (#597) 2026-04-14 19:26:55 -07:00
README.es.md fix(agents): use Kilocode brand logo instead of illegible favicon (#1224) 2026-04-28 12:38:17 -07:00
README.ja.md fix(agents): use Kilocode brand logo instead of illegible favicon (#1224) 2026-04-28 12:38:17 -07:00
README.md
…
README.zh-CN.md fix(agents): use Kilocode brand logo instead of illegible favicon (#1224) 2026-04-28 12:38:17 -07:00
back-button-tasks-page.md feat(nav): back/forward traverses Tasks page visits (#1207) 2026-04-27 23:49:34 -07:00
cmd-j-scoped-jump-palette-plan.md feat: add browser tab search to Cmd+J jump palette (#675) 2026-04-15 12:54:56 -07:00
codex-account-switching-design.md feat(codex-accounts): shared runtime home for account switching (#768) 2026-04-17 21:51:06 -07:00
create-from-start-field.md fix: address review findings (#1078) 2026-04-24 21:58:21 -07:00
design-379.md feat: add searchable repo picker to new worktree dialog (#559) 2026-04-12 18:50:24 -07:00
design-preserve-scroll-position.md
…
file-explorer-external-drop.md feat: allow dropping external files into the file explorer (#618) 2026-04-13 22:04:49 -07:00
focus-follows-mouse-design.md
…
focus-follows-mouse-plan.md
…
performance-audit.md perf: systematic performance optimizations (#623) 2026-04-14 00:28:56 -07:00
performance-implementation-plan.md perf: systematic performance optimizations (#623) 2026-04-14 00:28:56 -07:00
preload-typecheck-hole.md fix(preload): collapse index.d.ts into type-checked api-types.ts (#1197) 2026-04-27 21:46:17 -07:00
quickly-jump-to-worktree.md fix: address review findings (#1078) 2026-04-24 21:58:21 -07:00
remote-folder-picker-redesign.md improve remote folder picker UI (#1240) 2026-04-28 18:52:31 -07:00
split-groups-rollout-pr1.md refactor: add split group model foundations (#644) 2026-04-14 14:39:01 -07:00
split-groups-rollout-pr2.md fix: harden terminal pane lifecycle for split groups (#641) 2026-04-14 16:23:01 -07:00
split-groups-rollout-pr3.md fix: restore worktrees through tab group ownership (#645) 2026-04-14 17:01:58 -07:00
split-groups-rollout-pr4.md feat: add split group UI with tab-bar context menus and resize handles (#646) 2026-04-14 19:01:11 -07:00
split-groups-rollout-pr5.md refactor: gate split group surface ownership in Terminal.tsx (#642) 2026-04-14 20:19:11 -07:00
split-groups-rollout-pr6.md feat: enable split groups renderer path (#669) 2026-04-15 13:12:54 -07:00
tab-group-model-follow-up.md feat: add split group UI with tab-bar context menus and resize handles (#646) 2026-04-14 19:01:11 -07:00
term-shortcut-fix.md fix: audit terminal shortcut interception (#519) 2026-04-11 23:24:04 -07:00
terminal-extended-keys.md fix(terminal): advertise kitty keyboard protocol for Shift+Enter (#1247) 2026-04-28 23:56:29 -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.