# Manage Orca Worktrees and Terminals

Orca projects often span worktrees, terminals, automations, and embedded browser tabs. This skill gives agents a precise CLI workflow for managing those Orca surfaces.

## Install

```bash
npx skillstore add stablyai/orca-cli
```

## Metadata

- Status: approved
- Slug: stablyai-orca-cli
- Skillstore revision: r1
- Version status: missing
- Tree hash: 6c26b0e863cee868fcd4462473fcadb74c6d0be0aaf5458378818e4188280c6c
- Author: stablyai
- GitHub username: stablyai
- License: MIT
- Repository: https://github.com/stablyai/orca/tree/main/skills/orca-cli/
- Ref: 3e4b6c31a74a3bd1a291c98cf585d720cb9fbc88
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, network
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/stablyai-orca-cli
- Manifest: https://skillstore.pages.dev/api/skills/stablyai-orca-cli/manifest

## Capabilities

- Check Orca status and list repos, worktrees, terminals, and active contexts using JSON CLI output.
- Create Orca worktrees, manage parent lineage, set comments, and update workspace status.
- Start Codex or Claude agents in Orca terminals and send handoff prompts.
- Read, wait on, create, split, rename, stop, switch, and close Orca terminal sessions.
- Create, edit, run, inspect, and remove scheduled Orca automations for repos or workspaces.
- Control Orca embedded browser tabs and Orca emulator surfaces through typed CLI commands.

## Use Cases

- Hand Off Coding Work: Create a clean Orca worktree, start an agent, and pass a focused task brief with the right lineage.
- Inspect Active Agent Sessions: List terminals, read recent output, wait for idle state, and send the next prompt only when appropriate.
- Automate Orca Workspace Tasks: Create scheduled prompts for repo reviews, issue triage, or workspace summaries with clear provider choices.

## Prompt Templates

### Check Orca State

```
Use Orca CLI to check whether Orca is running, then list my active worktrees and terminals. Summarize what is available.
```

### Create a Handoff Worktree

```
Create an independent Orca worktree for this task and start Codex there. Send a concise task brief and report the new worktree details.
```

### Review Terminal Progress

```
Find the active Orca terminal, read its latest output, wait for idle state if needed, and tell me whether it needs a follow-up prompt.
```

### Coordinate Browser and Automation Work

```
Use Orca CLI to inspect embedded browser tabs and scheduled automations for this workspace. Recommend the narrowest safe next command for each surface.
```

## Limitations

- Requires the Orca CLI to be installed and Orca to be running for most workflows.
- Controls only Orca-managed worktrees, embedded browser tabs, terminals, and emulator surfaces.
- Commands can modify local repositories, terminals, browser state, and scheduled automations.
- Advanced orchestration and emulator workflows may require the dedicated companion skills.

## Best Practices

- Run a status check before choosing worktree, terminal, automation, browser, or emulator commands.
- Use JSON output and the narrowest Orca selector that matches the requested scope.
- Read terminal or browser state before sending input unless the next action is explicit.

## Anti Patterns

- Using raw git worktree, Playwright, simctl, or ad hoc terminal control when Orca state is required.
- Sending terminal input, browser eval, cookie reads, uploads, or emulator exec commands without explicit user intent.
- Monitoring a full handoff after ownership has moved to another agent or worktree.

## Security Audit

- Audited at: 2026-07-09T08:38:30.759\+00:00
- Summary: No prompt injection or malicious exfiltration language was found in SKILL.md. Many static hits are Markdown formatting false positives, but several examples are real Orca CLI workflows that create worktrees, launch agents, send terminal input, schedule automations, and control browser or emulator state. These capabilities are legitimate for the skill and should require explicit user intent and narrow scoping.

## Stats

- Views: 0
- Downloads: 6
- Favorites: 0
- Popularity score: 0