用途：octocode-cli 用子命令在终端执行 Octocode MCP 工具，无需接入 MCP。适合在 shell 中检索代码、读取文件与查询仓库信息。
主要能力（每个子命令对应一个工具）：search-code 查找符号定义或使用位置，用 --query 'symbol' --owner X --repo Y；get-file 读取指定文件整体或窗口，用 --match-string 'anchor' 或 --start-line N --end-line M 或 --full-content；view-structure 查看仓库结构，用 --depth 2；search-repos 按主题与热度找仓库，用 --topics a,b --stars '>=100'；search-prs 查 PR 历史，用 --owner X --repo Y --merged；package-search 把包解析到仓库并读元数据，用 --name pkg --ecosystem npm。
使用方式：加 --json 输出紧凑 structuredContent，可管道给 jq。列表参数用逗号分隔；kebab 形式映射为 camel 字段，如 --match-string 对应 matchString；布尔标志不带值，如 --merged、--draft、--full-content、--with-comments、--with-commits、--npm-fetch-metadata、--python-fetch-metadata；数字标志 --limit、--depth、--start-line、--end-line 传非数字会以退出码 1 结束。id、mainResearchGoal、researchGoal、reasoning 会自动填充，不需要传。成功退出 0，缺参数、stdin 有误、校验失败或工具报错退出 1。
效率建议：独立调用可并行发出；首次查询尽量宽泛，避免反复用 search-code 收窄；同一命令重复超过两次时可通过 stdin 批量执行：printf '{"queries":[{"keywordsToSearch":["useState"],"owner":"facebook","repo":"react"},{"keywordsToSearch":["useEffect"],"owner":"facebook","repo":"react"}]}' | octocode-cli search-code --json | jq。
认证：优先使用 Octocode 存储的凭据，其次使用 gh CLI token，可运行 octocode-cli login 或 gh auth login。
限制：具体收费、价格、支持平台及更多细节暂未提供。