Dev Instance
yc-software/qm
Run the current worktree as a production-shaped local dev instance with web, Slack, or both, on a real LLM + Postgres.
Use the Prowl CLI (prowl) to inspect or control a running Prowl GUI app and the agent sessions it hosts.
Install Prowl CLI
$ npx skills add onevcat/Prowl --skill prowl-cli -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install onevcat/Prowl prowl-cli --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/onevcat/Prowl.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/prowl-cli .claude/skills/prowl-cli && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "prowl-cli" agent skill from https://github.com/onevcat/Prowl/tree/main/skills/prowl-cli into .claude/skills/prowl-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prowl-cli", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/onevcat/Prowl/tree/main/skills/prowl-cliType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add onevcat/Prowl --skill prowl-cli -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install onevcat/Prowl prowl-cli --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/onevcat/Prowl.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/prowl-cli .agents/skills/prowl-cli && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "prowl-cli" agent skill from https://github.com/onevcat/Prowl/tree/main/skills/prowl-cli into .agents/skills/prowl-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prowl-cli", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add onevcat/Prowl --skill prowl-cli -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install onevcat/Prowl prowl-cli --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/onevcat/Prowl.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/prowl-cli .cursor/skills/prowl-cli && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "prowl-cli" agent skill from https://github.com/onevcat/Prowl/tree/main/skills/prowl-cli into .cursor/skills/prowl-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prowl-cli", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/onevcat/Prowl.git --path skills/prowl-cli--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add onevcat/Prowl --skill prowl-cli -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install onevcat/Prowl prowl-cli --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/onevcat/Prowl.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/prowl-cli .gemini/skills/prowl-cli && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "prowl-cli" agent skill from https://github.com/onevcat/Prowl/tree/main/skills/prowl-cli into .gemini/skills/prowl-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prowl-cli", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install onevcat/Prowl prowl-cliInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add onevcat/Prowl --skill prowl-cli -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/onevcat/Prowl.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/prowl-cli .github/skills/prowl-cli && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "prowl-cli" agent skill from https://github.com/onevcat/Prowl/tree/main/skills/prowl-cli into .github/skills/prowl-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prowl-cli", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add onevcat/Prowl --skill prowl-cli -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install onevcat/Prowl prowl-cli --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/onevcat/Prowl.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/prowl-cli .opencode/skills/prowl-cli && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "prowl-cli" agent skill from https://github.com/onevcat/Prowl/tree/main/skills/prowl-cli into .opencode/skills/prowl-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prowl-cli", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
prowl-cli- GitHub stars
- 631
- Token cost
- ~7.6k tokens
- SKILL.md length
- 3,408 words
- Files
- 1
- Skills in repo
- 10
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Use the Prowl CLI (prowl) to inspect or control a running Prowl GUI app and the agent sessions it hosts.
- Tasks that involve Git worktrees
- SKILL.md covers Who You Are, Safe Default Workflow, Common Recipes and Parsing JSON Output, plus 6 more sections
- Calls jq and codex; needs UNSUPPORTED_KEY and PROWL_WORKFLOW_TOKEN
What it does
Prowl CLI is an agent skill from onevcat/Prowl. Use the Prowl CLI (prowl) to inspect or control a running Prowl GUI app and the agent sessions it hosts. Prowl runs several coding agents in parallel, each in its own pane/tab/worktree, so reach for this whenever the user wants to act on a pane other than the current one — check on, coordinate, read from, focus, send text or keys to, open, or close another pane, tab, worktree, split, window, or sibling/neighboring agent. Covers colloquial framings that never say "prowl": "check what the agent in my other window…
Its SKILL.md is about 7.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development, covering Git worktrees. It works with npm. The repository describes itself as: native macOS codings agent orchestrator.
When your agent uses it
- Tasks that involve Git worktrees
Example prompts
- “check what the agent in my other window is doing”
- “are any of my agents running side by side still working or idle?”
- “tell the agent in my left split to rerun the tests”
- “/prowl-cli”
What it can do on your machine
Read from SKILL.md and the folder at commit 386b8d0. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
jqcodex
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
UNSUPPORTED_KEYPROWL_WORKFLOW_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Prowl CLI loads about 7.6k tokens when it runs. Until then it costs about 252 tokens; SKILL.md has 3,408 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 3,408 words (~7,589 tokens).
“Use prowl only when the task is to inspect or control the running Prowl GUI app: read panes, check sibling agents, focus a pane, open a repo/path in Prowl, send text, send keys, or create/close panes and tabs. Do not…”
- name
- prowl-cli
- metadata.prowl-summary
- Lets an agent drive the running Prowl app through the prowl command — list panes, read or message sibling agents, send text and keys, create or close tabs and…
Files
Just SKILL.md in skills/prowl-cli of onevcat/Prowl.
Open the folder on GitHubat commit 386b8d0
Compare with similar skills
Prowl CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Prowl CLI this skillonevcat/Prowl | 631 | — | ~7.6k | Automated safety check: Pass | Custom licence | |
| Dev Instanceyc-software/qm | 15k | — | ~3.7k | Automated safety check: Notes | MIT | |
| Harness ContributingFairladyZ625/harness-anything | 225 | — | ~4.2k | Automated safety check: Pass | AGPL-3.0 | |
| HousecleanSethGammon/Citadel | 922 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Squad Git Branching Workflowmicrosoft/waza | 1.4k | 4 repos | ~1.5k | Automated safety check: Pass | MIT | |
| Cabloy Worktree Environmentcabloy/cabloy | 982 | — | ~2.9k | Automated safety check: Notes | MIT |
Similar skills
Harness Contributing
FairladyZ625/harness-anything
Contribute a public change to Harness Anything from a GitHub issue through an isolated worktree, scoped tests, manifest-selected gates, a complete bilingual PR body, review triage, and maintainer…
Houseclean
SethGammon/Citadel
Cross-drive storage audit and cleanup. An agent skill from SethGammon/Citadel.
- Official
Squad Git Branching Workflow
microsoft/waza
Dev-first branching model for the Squad project: feature work branches from dev, issue branches follow a naming rule and parallel issues use git worktrees.
Cabloy Worktree Environment
cabloy/cabloy
This skill must be used only when the user explicitly invokes /cabloy-worktree-environment or explicitly asks to perform the named Cabloy worktree-environment setup.
Move To Worktree
foyzulkarim/claude-lens
After /start-task: park the current clean, pushed feature branch in its own issue-numbered nested worktree (.worktrees/<issue) and return the primary checkout to current main, so the next parallel…
More from onevcat/Prowl
All 10 skills in this repoProwl UI Verification
onevcat/Prowl
Drives and verifies the native macOS Prowl Debug UI through accessibility automation, proving behavior with before-and-after evidence instead of reasoning from code.
Prowl Self-Verify
onevcat/Prowl
Runs an opt-in end-to-end verification of Prowl changes in a separate debug instance, writing a verification contract first and reporting pass, fail, skipped or inconclusive for every scenario.
Prowl Agent Workflows
onevcat/Prowl
Authors, validates, runs and participates in Prowl Agent Workflows, bundles that orchestrate several live coding agents inside the Prowl macOS app.
Prowl Performance Benchmark Runner
onevcat/Prowl
Runs Prowl's benchmark layers for a branch or release against recorded baselines, only when explicitly asked and the machine is quiet.
Release-Time Localization Sync
onevcat/Prowl
Catches an app's string catalog up with the code once per release: translating new text, pruning unused entries, and flagging unlocalized strings.
Write AI Doc
onevcat/Prowl
Create and maintain curated docs-ai/ records for substantial features and non-trivial, decision-shaping fixes (numbered entries with 000-plan.md before implementation and 001-action.md after).
Related
Works with
Categories
Questions about Prowl CLI
What does Prowl CLI do?
Use the Prowl CLI (prowl) to inspect or control a running Prowl GUI app and the agent sessions it hosts. Prowl CLI is an agent skill from onevcat/Prowl. Use the Prowl CLI (prowl) to inspect or control a running Prowl GUI app and the agent sessions it hosts.
When should I use Prowl CLI?
Prowl CLI fits situations like: tasks that involve Git worktrees.
How do I install Prowl CLI in Claude Code?
Run `npx skills add onevcat/Prowl --skill prowl-cli -a claude-code`. Or copy the skill folder (skills/prowl-cli in onevcat/Prowl) into .claude/skills/prowl-cli in your project. Claude Code loads it when a task matches its description.
How do I install Prowl CLI in Codex?
Run `npx skills add onevcat/Prowl --skill prowl-cli -a codex`. Or copy the skill folder (skills/prowl-cli in onevcat/Prowl) into .agents/skills/prowl-cli in your project. Codex loads it when a task matches its description.
Can I use Prowl CLI in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add onevcat/Prowl --skill prowl-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/prowl-cli, .gemini/skills/prowl-cli, .github/skills/prowl-cli and .opencode/skills/prowl-cli in your project.
What does Prowl CLI need to run?
Going by SKILL.md and its folder, Prowl CLI needs the command-line tools its instructions call (jq and codex) and credentials named UNSUPPORTED_KEY and PROWL_WORKFLOW_TOKEN.
Does Prowl CLI access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Prowl CLI safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Prowl CLI use?
Prowl CLI has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Prowl CLI use?
About 7.6k tokens (SKILL.md is roughly 30k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Prowl CLI?
Skills that share tags, products or a category with Prowl CLI: Dev Instance (yc-software/qm, 15k stars), Harness Contributing (FairladyZ625/harness-anything, 225 stars), Houseclean (SethGammon/Citadel, 922 stars) and Squad Git Branching Workflow (microsoft/waza, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Prowl CLI?
onevcat (a GitHub user) maintains it in onevcat/Prowl, which has 631 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 6, 2026.
Source: onevcat/Prowl on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.