ajet/gong-fu-cha
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
gong-fu-cha/README.md
Adam Jeniski 76adec16b6 update skills dir
2026-01-08 02:23:40 -05:00

3.7 KiB
Raw Blame History

Gong Fu Cha 🍵

Gong Fu Cha (工夫茶) - The art of making tea with skill.

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

Login to your Gitea instance:

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

Links