This repository provides Claude Code skills for working with Gitea's tea CLI tool, enabling seamless interaction with Gitea repositories directly from your terminal through Claude Code.

What is Tea?

Tea is the official command-line tool for Gitea. It allows you to:

Create and manage pull requests
Create and manage issues
Review code
Create releases
Manage labels and milestones
Clone repositories
And much more!

Installation

Install Tea CLI

macOS (Homebrew):

brew tap gitea/tap
brew install tea

Linux:

# Download latest release from https://gitea.com/gitea/tea/releases
# Or use your package manager

From source:

go install gitea.com/gitea/tea@latest

Setup Tea

tea login add --url https://git.ajet.fyi

Or use a token:

tea login add --url https://git.ajet.fyi --token YOUR_TOKEN

Verify your login:

tea whoami

Claude Code Skills

This repository provides a comprehensive Claude Code skill for the tea CLI.

Installing the Skill

The skill is located in the skills/tea/ directory. To use it with Claude Code, symlink it to your Claude Code skills directory:

ln -s /path/to/gong-fu-cha/skills/tea ~/.claude/skills/tea

For example:

ln -s ~/repos/ajet-industries/gong-fu-cha/skills/tea ~/.claude/skills/tea

Using the Skill

Once installed, you can invoke the skill in Claude Code with:

/tea

Or simply ask Claude to perform Gitea operations:

"Create a PR for this branch"
"List open issues"
"Review PR #42"
"Create a release tagged v1.0.0"

Common Tea Commands

Pull Requests

# List PRs
tea pr ls

# Create a PR
tea pr create -t "Title" -d "Description"

# Review a PR
tea pr checkout 42
tea pr approve 42
tea pr merge 42

Issues

# List issues
tea issues ls

# Create an issue
tea issues create -t "Bug: Fix something" -d "Details"

# Close an issue
tea issues close 42

Releases

# List releases
tea releases ls

# Create a release
tea releases create --tag v1.0.0 -t "Version 1.0.0" -n "Release notes"

Documentation

Tea Manual: Run tea man for comprehensive documentation
Command Help: Run tea <command> --help for command-specific help
Skill Documentation: See skills/tea/SKILL.md for Claude Code integration details
Examples: See skills/tea/examples.md for usage examples

Repository Structure

gong-fu-cha/
├── skills/
│   └── tea/
│       ├── SKILL.md      # Claude Code skill definition
│       └── examples.md   # Usage examples
├── README.md             # This file
└── CLAUDE.md             # Instructions for Claude Code

Why "Gong Fu Cha"?

Gong Fu Cha (工夫茶) is a traditional Chinese tea ceremony that emphasizes skill, attention to detail, and the artful preparation of tea. Just as Gong Fu Cha is about mastering the art of tea, this repository is about mastering the art of using tea - the Gitea CLI tool - with skill and efficiency through Claude Code.

The name is also a play on words:

Tea = The CLI tool for Gitea
Gong Fu (功夫) = Skill, mastery, kung fu
Cha (茶) = Tea

Perfect harmony! 🍵✨

License

MIT

Contributing

Contributions welcome! Feel free to:

Add new examples to the skill documentation
Improve existing documentation
Add new workflows
Report issues

README.md

Gong Fu Cha 🍵