orca-cli

Operate Orca worktrees, terminals, repos, and artifacts through the orca CLI.

1|Updated May 3, 2021
One-click install
npx skills add https://github.com/leogurja/dotfiles --skill orca-cli-leogurja
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orca-cli
Source: https://github.com/leogurja/dotfiles/tree/main/home/dot_agents/skills/orca-cli
Command: npx skills add https://github.com/leogurja/dotfiles --skill orca-cli-leogurja

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Orca-managed worktrees, terminals, and artifacts by hand requires ad hoc git worktree commands, manual PTY handling, and guesswork about which Orca executable to invoke, which risks targeting the wrong binary or an incompatible Orca version. ## Core Features & Use Cases - Executable Resolution: Selects the correct Orca binary for the session (ORCA_CLI_COMMAND, orca-dev, orca-ide, or orca) and avoids accidentally launching the GNOME Orca screen reader on Linux. - Version-Matched Guidance: Loads the CLI guide matching the installed Orca build via ORCA skills get orca-cli, so commands and flags always correspond to the running version. - Worktree and Terminal Operations: Covers spawning agents in child worktrees, reading and sending to Orca terminals, handoffs between agents, artifacts, skill sharing, and the embedded Orca browser. - Use Case: A user asks to spawn a coding agent in a child worktree and hand off the current task; the Skill resolves the right executable, loads the matching guide, and runs the correct Orca commands. ## Quick Start Ask the assistant to use the orca-cli skill to spawn an agent in a new Orca worktree and read its terminal output.

Frequently Asked Questions about orca-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I spawn a coding agent in an Orca worktree?▼

Resolve the correct Orca executable for your session, then run `ORCA skills get orca-cli` to load the version-matched guide, which documents the worktree and agent-spawning commands. Use the executable's `--help` for flags the guide does not cover.

Which Orca executable should I use on Linux?▼

On Linux outside an Orca-managed terminal, use `orca-ide`. Never run bare `orca` there, because it usually resolves to the GNOME Orca screen reader at /usr/bin/orca and starts speech on the machine.

When should I use Orca CLI instead of git worktree or Computer Use?▼

Prefer the Orca CLI whenever Orca state is involved, such as managed worktrees, terminals, or artifacts. Use Computer Use only for external windows needing OS-level control, and Playwright or CDP for external web pages.

What should I do if the orca skills get command is unknown?▼

An unknown `skills get` command means the Orca build is outdated; updating Orca restores the guide. Until then, use the executable's `--help` for read-only discovery and do not guess unsupported commands.

Why does the Orca CLI report that Orca is not running?▼

This error means the Orca application is not active for the session. Start it with `ORCA open --json` and then retry the original command.