179 lines
3.7 KiB
Markdown
179 lines
3.7 KiB
Markdown
# 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](https://gitea.com/gitea/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):**
|
|
```bash
|
|
brew tap gitea/tap
|
|
brew install tea
|
|
```
|
|
|
|
**Linux:**
|
|
```bash
|
|
# Download latest release from https://gitea.com/gitea/tea/releases
|
|
# Or use your package manager
|
|
```
|
|
|
|
**From source:**
|
|
```bash
|
|
go install gitea.com/gitea/tea@latest
|
|
```
|
|
|
|
### Setup Tea
|
|
|
|
Login to your Gitea instance:
|
|
|
|
```bash
|
|
tea login add --url https://git.ajet.fyi
|
|
```
|
|
|
|
Or use a token:
|
|
|
|
```bash
|
|
tea login add --url https://git.ajet.fyi --token YOUR_TOKEN
|
|
```
|
|
|
|
Verify your login:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
ln -s /path/to/gong-fu-cha/skills/tea ~/.claude/skills/tea
|
|
```
|
|
|
|
For example:
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
- [Gitea Tea CLI](https://gitea.com/gitea/tea)
|
|
- [Gitea Documentation](https://docs.gitea.io/)
|
|
- [Claude Code](https://claude.ai/code)
|