tea 是 Gitea 的命令行工具,作为生产力助手,可管理一个或多个 Gitea 实例上的大部分实体,并提供本地辅助功能。
用途:管理 Gitea 仓库(创建、复刻、迁移、删除);处理议题(列出、创建、编辑、关闭、重开);管理拉取请求(列出、创建、检出、合并、评审、批准、拒绝);管理标签、里程碑和发布;跟踪议题/PR 上的时间;管理组织;处理分支(列出、保护、取消保护);管理 GitHub Actions(密钥、变量、运行、工作流);管理 Webhook;查看和管理通知。
主要能力:通过登录系统管理 Gitea 服务器连接,每个登录存储服务器 URL、认证方式(令牌、OAuth、SSH 密钥或基本认证)及可选的客户端 ID、作用域、OTP 令牌。tea 会尝试使用 $PWD 中仓库提供的上下文,可用 --repo 或 --remote 覆盖。所有命令支持 --output(-o)输出格式:simple、table、csv、tsv、yaml、json。
使用方式:先认证,运行 tea logins add 添加登录,再执行其他命令。常用命令包括 tea logins list、tea issues list、tea pulls create、tea repos create、tea actions runs list 等。安装可通过包管理器或从发布页下载,也可用 go install github.com/gitea/tea@latest。配置存储在 $XDG_CONFIG_HOME/tea(通常为 ~/.config/tea)。
适用场景:在终端中高效操作 Gitea 上的仓库协作流程,适合脚本化输出(--output json/yaml)和分页(--limit、--page)。
限制:大多数命令需要先登录;删除命令通常需要 --confirm 或 -y 跳过提示;tea pulls checkout 创建本地分支但不会自动切换,需随后 git checkout;时间格式接受如 "2h30m" 或 "150m";不在 git 仓库中时需用 --repo owner/repo 指定仓库。