orca/docs
Jinjing 28a1c93c8c
feat: allow dropping external files into the file explorer (#618)
Add support for dragging files from the OS into the file explorer sidebar.
Files are copied (not moved) into the target directory within the worktree.

- Preload detects native file drops via capture-phase listener and resolves
  the drop target (editor, terminal, or file-explorer) from DOM attributes
- New IPC handler `fs:importExternalPaths` copies files/directories with
  symlink pre-scanning, path-traversal protection, and dedup on conflict
- FileExplorer tracks native drag state separately from internal drag state
  to show correct drop highlights without interfering with tree reordering
- FileExplorerRow expands directories on hover during native drags
- useFileExplorerImport hook subscribes to preload IPC events and drives
  the import → refresh → reveal pipeline

Includes review fixes:
- Clear nativeDropTargetDir on row drag-leave to prevent stale highlights
- Clear native drag state on early return in useFileExplorerImport
- Extract row drag logic to useFileExplorerRowDrag hook
- Split import tests into dedicated filesystem-import.test.ts
- Use T[] syntax instead of Array<T> per lint rules
- Use ternary expressions for simple if/else per lint rules
2026-04-13 22:04:49 -07:00
..
assets Add Codex account switcher gif (#489) 2026-04-11 12:39:02 -07:00
superpowers Add Cmd+G / Cmd+Shift+G terminal search navigation (#440) 2026-04-11 22:52:32 -07:00
README.ja.md docs: center language links below badges and use for-the-badge style (#608) (#608) 2026-04-13 18:48:08 -07:00
README.md Add Orca runtime CLI and bundled install support (#273) 2026-04-03 16:50:28 -07:00
README.zh-CN.md docs: center language links below badges and use for-the-badge style (#608) (#608) 2026-04-13 18:48:08 -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 refactor to clean up the codebase (#412) 2026-04-08 22:49:16 -07:00
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 feat: focus-follows-mouse setting for terminal panes (#389) 2026-04-09 17:02:01 -07:00
focus-follows-mouse-plan.md feat: focus-follows-mouse setting for terminal panes (#389) 2026-04-09 17:02:01 -07:00
quickly-jump-to-worktree.md feat: Quick Jump to Worktree palette (Cmd+J) (#469) 2026-04-10 23:37:23 -07:00
term-shortcut-fix.md fix: audit terminal shortcut interception (#519) 2026-04-11 23:24:04 -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.