skills.rest
cbrostrom
cbrostromCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

orca-cli

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

Updated Nov 25, 2024
Search Tags:#cli#agent orchestration#worktree#artifacts#handoff#terminal#orca
One-click install
npx skills add https://github.com/cbrostrom/dotfiles --skill orca-cli-cbrostrom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orca-cli
Source: https://github.com/cbrostrom/dotfiles/tree/main/stow/agents/.agents/skills/orca-cli
Command: npx skills add https://github.com/cbrostrom/dotfiles --skill orca-cli-cbrostrom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Orca-managed worktrees, terminals, and agent handoffs manually requires ad hoc git worktree commands, raw PTYs, or fragile UI automation, which breaks when Orca state is involved. ## Core Features & Use Cases - Executable Resolution: Selects the correct Orca CLI binary per 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 guide matching the installed Orca build via orca skills get orca-cli before running commands, with fallback to --help for read-only discovery. - Use Case: When asked to spawn a Codex or Claude agent in a child worktree, read or send input to an Orca terminal, or hand off work to another agent, this Skill ensures commands target the correct Orca instance and version. ## Quick Start Ask the assistant to spawn a Claude agent in a new Orca child worktree and wait for 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 Codex or Claude agent in an Orca worktree?▼

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

How do I read or send input to an Orca terminal?▼

Load the version-matched guide with `orca skills get orca-cli`, which documents terminal read, wait, and send operations. Prefer `--json` output for structured results when scripting terminal interactions.

Why does running orca on Linux start a screen reader?▼

Outside Orca-managed terminals on Linux, bare `orca` resolves to the GNOME Orca screen reader at /usr/bin/orca. Use `orca-ide` instead in that context to target the Orca CLI without starting speech output.

What should I do if the orca command reports Orca is not running?▼

Start Orca with `orca open --json` and retry the command. If `skills get` is unknown, the Orca build is outdated; updating Orca restores the guide, and `--help` can be used for read-only discovery meanwhile.

When should I use Computer Use or Playwright instead of the Orca CLI?▼

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

Related Skills

Explore More Software Engineering Skills→
rickylabsrickylabs

codex-wsl-remote

Manage Codex app-server sessions in WSL through SSH connections.

Community
Advanced
crowicrowi
1.1k

integrate-worktree

Merges finished git worktree branches into main, closes worktrees, and runs post-merge quality checks.

Official
Advanced
leogurjaleogurja
1

orca-cli

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

Community
Intermediate
stablyaistablyai
40.6k

orca-cli

Orchestrate Orca worktrees, terminals, and browser automation via CLI.

Official
Advanced