octocode-cli
Installation
SKILL.md
Octocode CLI — Agent Playbook
Six subcommands, one tool each. Pick by task shape. Always add --json and pipe to jq.
Task → Command
| What you need | Command | Key flags |
|---|---|---|
| Find where a symbol is defined or used | search-code |
--query 'symbol' --owner X --repo Y |
| Read a specific file (whole or a window) | get-file |
--match-string 'anchor' or --start-line N --end-line M or --full-content |
| Map a repo's layout | view-structure |
--depth 2 |
| Find repos by topic/popularity | search-repos |
--topics a,b --stars '>=100' |
| PR history on a repo | search-prs |
--owner X --repo Y --merged |
| Resolve a package to a repo + read metadata | package-search |
--name pkg --ecosystem npm |
Core discipline
These three rules decide whether the CLI is fast or slow: