Octocode CLI — Agent Playbook

Binary: octocode. Run octocode --help to see everything; it prints an <AGENT_INSTRUCTIONS> block plus the full command list. Two surfaces:

1. Quick commands — friendly shortcuts that auto-route a local path vs an owner/repo. Use these first.
2. Raw tools — octocode tools <name> --queries '<json>' runs an Octocode MCP tool directly. Read the schema FIRST.

Discipline (read this first)

• Do NOT hallucinate paths, line numbers, or fields — verify with the tools. Search snippets are discovery, not proof; re-read the exact text before quoting.
• Flow: locate → search → read the smallest slice → prove. Pick the cheapest tool that answers the current question.
• One wide query beats five narrow ones. If results are reasonable, read them — don't re-query to "narrow down".
• Parallelize independent calls — issue them in one message so the shell runs them concurrently.
• Output: clean YAML by default (read it directly). Add --json for the raw envelope, --compact for the leanest text.

Task → quick command