claude-memory/graph/decisions/migrated-gitea-operations-from-tea-cli-to-gitea-mcp-mcp-serv-d32609.md
2026-02-28 16:11:08 -06:00

2.0 KiB

id type title tags importance confidence created updated relations
d326094f-63eb-4b42-8aa6-f2d53d6f2628 decision Migrated Gitea operations from tea CLI to gitea-mcp MCP server
gitea
mcp
claude-code
tea-cli
claude-configs
decision
tooling
0.8 0.8 2026-02-26T01:00:32.395054+00:00 2026-02-28T22:11:08.332788+00:00
target type direction strength edge_id
5994fea1-f787-41a3-ad5b-0f3349c00343 RELATED_TO incoming 0.7 ae71b8bf-3993-4ca6-90a4-b5a3a8f5b46a

Migrated Gitea Operations from tea CLI to gitea-mcp MCP Server

Context

Previously, all Gitea operations in Claude Code sessions used the tea CLI via Bash tool calls, requiring --repo owner/name on every command due to tea's inability to auto-detect from git remotes.

Decision

Switch to preferring the mcp__gitea-mcp__* tools (gitea/gitea-mcp v0.8.1) for all Gitea operations, with tea CLI as fallback only.

Rationale

  • Superset of tea CLI: 100+ MCP tools covering PRs, issues, branches, labels, releases, Actions, wiki, and PR reviews
  • Native tool calls: No subprocess overhead, structured JSON responses
  • No boilerplate: Eliminates the --repo owner/name requirement on every command
  • Always-on: Configured at user scope via ~/.claude.json, available in all sessions

Files Updated

  1. ~/.claude/CLAUDE.md — Gitea Operations section updated to say "Prefer the gitea-mcp MCP server" with tea CLI as fallback
  2. ~/.claude/commands/commit-push-pr.md — Replaced Bash(tea pulls create:*) with mcp__gitea-mcp__create_pull_request in allowed-tools and instructions

Unchanged Files

  • commit.md and commit-push.md — no Gitea operations, no changes needed

Key Tool Mappings

Old (tea CLI) New (MCP)
tea pulls create --repo owner/name mcp__gitea-mcp__create_pull_request
tea pulls list --repo owner/name mcp__gitea-mcp__list_repo_pull_requests
tea issues list --repo owner/name mcp__gitea-mcp__list_repo_issues

Commit

Synced to cal/claude-configs repo at commit 8642bb5.