Files

Matt Kost 6edbe46a1f Add gitea skill - replaces 42.7k token Gitea MCP

- Wraps tea CLI for Gitea operations
- Supports issues, PRs, releases, labels, milestones
- 95% context savings vs MCP (42.7k → ~2k tokens)
- First skill in collection

2026-01-04 02:19:47 -05:00

3.3 KiB

Raw Permalink Blame History

name, description, allowed-tools

name	description	allowed-tools
gitea	Interact with Gitea repositories using tea CLI. Use when managing issues, pull requests, releases, repos, labels, milestones on gitea.kostverse.com	Bash

Gitea Management via tea CLI

You have access to the tea CLI for managing Gitea repositories. This is a lightweight alternative to the Gitea MCP.

Authentication

Already configured:

Login: kostverse
URL: https://gitea.kostverse.com
User: matt

Always use --login kostverse with commands.

Common Operations

Issues

List issues:

tea issues list --repo OWNER/REPO --login kostverse

Create issue:

tea issues create --repo OWNER/REPO --login kostverse \
  --title "Issue title" \
  --description "Issue body" \
  --labels "bug,enhancement" \
  --assignees "username"

Close issue:

tea issues close ISSUE_NUMBER --repo OWNER/REPO --login kostverse

Comment on issue:

tea comment ISSUE_NUMBER --repo OWNER/REPO --login kostverse \
  --body "Comment text"

Pull Requests

List PRs:

tea pulls list --repo OWNER/REPO --login kostverse

Create PR:

tea pulls create --repo OWNER/REPO --login kostverse \
  --head BRANCH --base main \
  --title "PR title" \
  --description "PR body"

Merge PR:

tea pulls merge PR_NUMBER --repo OWNER/REPO --login kostverse

Repositories

List repos:

tea repos list --login kostverse

Clone repo:

tea clone OWNER/REPO --login kostverse

Labels

List labels:

tea labels list --repo OWNER/REPO --login kostverse

Create label:

tea labels create --repo OWNER/REPO --login kostverse \
  --name "label-name" \
  --color "ff0000" \
  --description "Label description"

Releases

List releases:

tea releases list --repo OWNER/REPO --login kostverse

Create release:

tea releases create --repo OWNER/REPO --login kostverse \
  --tag v1.0.0 \
  --title "Release title" \
  --note "Release notes"

Milestones

List milestones:

tea milestones list --repo OWNER/REPO --login kostverse

Create milestone:

tea milestones create --repo OWNER/REPO --login kostverse \
  --title "Milestone name" \
  --description "Milestone description" \
  --deadline "2026-12-31"

Tips

Always use --login kostverse - Specifies which Gitea instance to use
Repo format - Use OWNER/REPO format (e.g., matt/aurai-v2)
Help - Use tea COMMAND --help for detailed options
Output - Most commands output tables or formatted text
Error handling - Check exit codes and stderr for failures

Example Workflows

Triage new issue

tea issues list --repo matt/REPO --login kostverse - See all issues
Read the issue details
Add labels: tea issues create with --labels flag
Assign: tea issues create with --assignees flag

Create PR from feature branch

Make commits locally
Push branch to Gitea
tea pulls create --repo matt/REPO --login kostverse --head feature-branch --base main --title "..." --description "..."
Get PR URL from output

Ship a release

Tag the commit: git tag v1.0.0 && git push origin v1.0.0
tea releases create --repo matt/REPO --login kostverse --tag v1.0.0 --title "v1.0.0" --note "Release notes here"
Verify at output URL

3.3 KiB Raw Permalink Blame History