peky

Overview

Use this skill to operate peky safely and predictably from the CLI, especially when automating or controlling panes via an AI agent.

Quick Rules (read first)

• Do not guess flags. Use peky <command> --help before running.
• Use --yes for side effects to avoid hanging prompts in non-interactive runs.
• Scopes are only session|project|all. Never pass project names to --scope.
• Project scope requires focus. If you see "focused project unavailable," run peky session focus --name <session> first.
• Prefer pane IDs for precision. Use pane list --json and pick the pane id.
• Shortcut: use --pane-id @focused to target the currently focused pane.
• pane add defaults to active pane. For deterministic automation, pass --pane-id or --session + --index.

Targeting: Session vs Project vs Pane ID

1. Find session names

peky session list