skills.rest
Chia1104
Chia1104COMMUNITY
Explore all skills by this author →
Website𝕏@chia7423GitHub

orca-cli

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

1|Updated Aug 11, 2026
Search Tags:#automation#cli#multi-agent#worktree#terminal#agent handoff#orca
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill orca-cli-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orca-cli
Source: https://github.com/Chia1104/agent-air/tree/main/skills/shared/orca-cli
Command: npx skills add https://github.com/Chia1104/agent-air --skill orca-cli-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Orca-managed worktrees, terminals, and agent handoffs requires knowing the correct CLI executable and version-matched commands; using the wrong binary (such as the GNOME Orca screen reader) or guessing unsupported commands leads to errors and inconsistent state. ## Core Features & Use Cases - Executable Resolution: Selects the correct Orca CLI binary based on environment variables (ORCA_CLI_COMMAND, ORCA_DEV_REPO_ROOT) and platform context, avoiding accidental invocation of the GNOME screen reader. - Version-Matched Guide Loading: Fetches the authoritative command reference via orca skills get orca-cli so instructions always match the installed Orca build. - Use Case: When a user asks to spawn a Codex or Claude agent in a child worktree, read an Orca terminal, or hand off work to another agent, this Skill ensures the right executable and current command syntax are used. ## Quick Start Ask the agent 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, which documents the worktree and agent spawn commands. Use `--json` output for structured results.

Which orca command should I use on Linux?▼

On Linux outside an Orca-managed terminal, use `orca-ide`, never bare `orca`, because bare `orca` typically resolves to the GNOME Orca screen reader and starts speech. Inside managed WSL sessions, use the ORCA_CLI_COMMAND environment variable value.

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

Start Orca with `orca open --json` and retry the command. If the selected executable cannot run at all, report its exact error and stop rather than falling through to another binary that could target a different build.

When should I use Computer Use instead of the orca CLI?▼

Use Computer Use only when a visible window needs GUI control that a CLI, filesystem, or API cannot accomplish. Prefer the orca CLI over raw git worktree commands or ad hoc PTYs whenever Orca state is involved.

What if the skills get command is unknown in my Orca version?▼

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

Related Skills

Explore More Software Engineering Skills→
cbrostromcbrostrom

orca-cli

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

Community
Intermediate
DyreanDyrean

factory-worktree

Create isolated jj or git worktrees for parallel agent development.

Community
Advanced
stablyaistablyai
40.6k

orca-cli

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

Official
Advanced
leogurjaleogurja
1

orca-cli

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

Community
Intermediate