mcpField
F
forgejo-cli

forgejo-cli

github.com/magnus919开发15361 次安装今天更新
代码仓库

关于 forgejo-cli

用于通过命令行操作 Forgejo 安装实例的 Python CLI，面向日常仓库和协作管理。它提供常用命令组，也可通过通用 API 命令访问其他 API 端点，并支持变更预览。

主要功能

  1. 01管理 Issue、PR、仓库及其他常用资源
  2. 02通过通用 API 命令调用其他端点
  3. 03支持分页列表与搜索
  4. 04以 dry-run 预览写操作计划
  5. 05输出单一 JSON 结果并分离诊断信息

适用场景

  1. 01列出仓库中的 Issue
  2. 02预览创建私有仓库的操作
  3. 03调用未覆盖的 Forgejo API 端点
  4. 04检查分页响应及总数信息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/magnus919/agent-skills --skill forgejo-cli

安装后在 Claude Code 中输入/forgejo-cli确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
V2-SPEC.md
evals/
evals.json
references/
api-usage.md
command-reference.md
endpoint-routing.md
troubleshooting.md
scripts/
forgejo-cli
tests/
test_cli.py

详细介绍

Forgejo CLI v2

运行 python3 scripts/forgejo-cli。--agent（默认）使用 FORGEJO_AGENT_TOKEN；--user 使用 FORGEJO_USER_TOKEN；--server URL 用于选择一个实例。如果包装器提供了 FORGEJO_SERVER，请在 shell 中设置；否则请显式传入 --server。

安全

  • 修改操作需要 --force/--yes/-y，或 --dry-run。
  • --dry-run --json 会输出一个包含 method、path、query 和 body 的计划；不会发出网络请求。
  • --json 会向标准输出准确写入一个 JSON 值；诊断信息写入标准错误。
  • --page 和 --limit 适用于任何列表/搜索请求。添加 --include-response 可获取 HTTP 状态以及 link 和 x-total-count 分页标头。
  • --help 不会读取凭据或联系服务端。路径段会进行编码。

常见工作流

python3 scripts/forgejo-cli issue list --owner acme --repo app --json
python3 scripts/forgejo-cli --dry-run --json repo create --name demo --private
python3 scripts/forgejo-cli --dry-run --json api --method POST \
  --path /api/v1/repos/acme/app/actions/variables --data '{"name":"KEY","value":"value"}'

一等命令组：issue、pr、repo、content、label、milestone、release、hook 和 user。content 需要 base64；更新/删除操作需要当前 SHA。其他 /api/v1/ 端点请使用 api；它支持 JSON、原始文件、多部分上传/表单以及自定义标头。请查阅所选服务端上的 /api/swagger 或 /swagger.v1.json。参见命令参考。

选择命令

日常工作流适用一等命令时，请使用该命令。若操作不受支持、需要特定版本的字段，或需要简单标志无法表示的架构，请使用 api。使用 api 前，请阅读端点路由；有关身份验证、分页、兼容性和安全的架构发现，请阅读 API 使用指南。对于 401/403/422 响应和传输故障，请阅读故障排除。

评论

支持 Markdown