openJiuwen-ai gitcode-api CLI
使用 gitcode-api 命令行调用 GitCode REST API。这个技能只覆盖 gitcode-api 1.2.14 及以上版本的 CLI。
Quickstart
- 先确认 CLI 是否可用：
gitcode-api --version
- 如果未安装或版本低于
1.2.14，提示用户安装或升级：
pip install -U gitcode-api
也可以使用 uv 临时运行或安装：
uvx gitcode-api --version
uv pip install -U gitcode-api
- 优先使用环境变量保存 token，避免把 token 写进命令历史：
- 用户需要在
~/.jiuwenclaw/config/.env中配置GITCODE_ACCESS_TOKEN环境变量 - 若用户没有GitCode token，告知可以使用此链接新建并按需配置读写权限：https://gitcode.com/setting/token-classic
- CLI 基本形状：
gitcode-api <resource> <method> [options]
例如：
gitcode-api repos get --owner openJiuwen --repo agent-core
gitcode-api pulls list --owner openJiuwen --repo agent-core --state open
gitcode-api search repositories --q sdk
- 不确定命令或参数时，先看 help，不要猜参数：
gitcode-api --help
gitcode-api pulls --help
gitcode-api pulls create --help
使用原则
- 优先运行
gitcode-api --version和分级 help 来确认本机实际 CLI 能力。 - 资源组和方法名使用 kebab-case，例如 SDK 的
build_authorize_url在 CLI 中是build-authorize-url。 - 大多数命令输出 JSON；需要机器处理时使用
--compact，需要保存结果时使用--output-file。 - 遇到
**params或**payload类型的额外参数，用--set key=value或--set-json '{...}'。 - 如果用户要求的是完整开发流程、提交、创建 PR、解决 Issue，本技能只负责 GitCode CLI 查询或调用部分，不负责端到端工程流程。
何时阅读参考文件
- 安装、版本、token、
uv用法：读 references/install-and-auth.md。 - CLI 语法、通用参数、输出保存、转义：读 references/cli-usage.md。
- 查找资源组、方法、参数签名：读 references/command-discovery.md。
- 常见任务示例：读 references/common-recipes.md。
- 报错、权限、参数、MCP server 问题：读 references/troubleshooting.md。
任务文档
- 总结仓库最近 commit / PR / issue、责任人、模块、风险或对外接口影响：读 tasks/summarize-repo-changes.md。
脚本入口
如果当前环境更适合运行 Python 脚本（不建议），可调用：
python scripts/gitcode_api_cli.py --help
该脚本只是 gitcode_api.cli.main 的薄封装，行为应与 gitcode-api 控制台命令一致。
企业网络 SSL / 自定义 CA
可通过设置环境变量 GITCODE_CA_BUNDLE 或 REQUESTS_CA_BUNDLE 指定默认CA 证书路径。