# 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/` directory. To use it with Claude Code:

1. This repository should be in your Claude Code skills directory, or
2. Symlink the skills directory to `~/.claude/skills/tea`:
   ```bash
   ln -s /path/to/gong-fu-cha/skills ~/.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/SKILL.md` for Claude Code integration details

## Repository Structure

```
gong-fu-cha/
├── skills/
│   └── SKILL.md         # Claude Code skill definition
├── 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)