# gitea-cli

Tiny stdlib-only Python helper for common operations against the local self-hosted Gitea instance.

Defaults:

- `GITEA_URL=http://192.168.33.22:3300`
- `GITEA_USER=gemma`

Credentials are read at runtime from:

1. `GITEA_TOKEN`
2. `GITEA_PASSWORD`
3. `/root/PASSWORD.md` line matching `gitea <password>`

## Install

```bash
sudo install -m 0755 gitea-cli /usr/local/bin/gitea-cli
sudo ln -sf /usr/local/bin/gitea-cli /usr/local/bin/gitea
```

## Usage

```bash
gitea version
gitea list
gitea list --json
gitea get arcana-fx
gitea create my-repo --description "description" --private
gitea create my-repo --dry-run
```