75 lines
2.7 KiB
Markdown
75 lines
2.7 KiB
Markdown
---
|
|
id: d326094f-63eb-4b42-8aa6-f2d53d6f2628
|
|
type: decision
|
|
title: "Migrated Gitea operations from tea CLI to gitea-mcp MCP server"
|
|
tags: [gitea, mcp, claude-code, tea-cli, claude-configs, decision, tooling]
|
|
importance: 0.8
|
|
confidence: 0.8
|
|
created: "2026-02-26T01:00:32.395054+00:00"
|
|
updated: "2026-03-03T21:25:54.799592+00:00"
|
|
relations:
|
|
- target: 5994fea1-f787-41a3-ad5b-0f3349c00343
|
|
type: RELATED_TO
|
|
direction: incoming
|
|
strength: 0.7
|
|
edge_id: ae71b8bf-3993-4ca6-90a4-b5a3a8f5b46a
|
|
- target: 7f7b08eb-5105-4e87-a0d3-4abfc3fd0f8d
|
|
type: FOLLOWS
|
|
direction: incoming
|
|
strength: 0.8
|
|
edge_id: cad194d0-6f4b-404f-ab5c-753cf65ba3d5
|
|
- target: 230a1d01-d47b-46ee-91f1-7388e3255b19
|
|
type: RELATED_TO
|
|
direction: incoming
|
|
strength: 0.58
|
|
edge_id: 8b79335d-84fa-4763-9684-e0886ef20c90
|
|
- target: 45c21973-7fae-4cf7-b247-b40a757d54b0
|
|
type: REQUIRES
|
|
direction: incoming
|
|
strength: 0.85
|
|
edge_id: 89529f58-d709-46e1-bbdd-c0636ee41b21
|
|
- target: 78841477-74c0-430a-8a69-9df80602bd6f
|
|
type: RELATED_TO
|
|
direction: incoming
|
|
strength: 0.7
|
|
edge_id: 1b542151-5a57-4e40-b2d4-43968ea5c8d1
|
|
---
|
|
|
|
# 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`.
|