forgejo-clilisted
Install: claude install-skill Xipher-Labs/walter-os
# Forgejo CLI (`tea`)
Forgejo is API-compatible with Gitea, so the official **`tea`** CLI works
1:1. Mature, stable, in apt/brew. Replaces the unmaintained community
forgejo-mcp.
## Setup (one-time, per machine)
```bash
brew install tea # macOS
# or: apt install gitea-tea # Ubuntu
# Configure login against Walter-VM Forgejo
tea login add \
--name walter-vm \
--url https://git.${WALTER_DOMAIN} \
--token "$FORGEJO_TOKEN" # generate at: git.${WALTER_DOMAIN}/user/settings/applications
# Verify
tea login list
tea repos list
```
`FORGEJO_TOKEN` lives in `~/.config/walter-os/secrets.env` (or Infisical
workspace `walter-os`). Scope it to the minimum: `repo:read`, `repo:write`
on a per-repo basis when you can.
## Common operations
### Repos
```bash
tea repos list # all repos visible to you
tea repos create --name foo --private # create private repo
tea repos clone <owner>/<repo> # clone via SSH
```
### Issues
```bash
tea issues list # in current repo
tea issues create --title "Bug X" --body "Steps: ..."
tea issues comment 42 --comment "Fixed in commit abc123"
tea issues close 42
```
### Pull requests
```bash
tea pulls list
tea pulls create --title "Add X" --description "Refs #42"
tea pulls checkout 17 # check out PR #17 locally
tea pulls merge 17 # merge (requires approval)
```
### Releases
```bash
tea releases list
tea rele