Prowl CLI

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, or send keys. Do not use it merely because the current shell is inside the Prowl repo.

Safe Default Workflow

Always resolve a concrete pane UUID before read, send, key, focus, or destructive close commands.

prowl list --json

Pick the target by pane.id, tab.id, worktree.id, worktree.path, pane.cwd, and pane.focused. Do not trust tab titles: they are free-form and can lag or lie.

When you specifically need active agent status, prefer the agent roster:

prowl agents --json