Installation

Requirements

• Python 3.12 or newer
• A forge.marvin8.zone account
• A Forgejo API token (required for live data; see below)

Install yilan

Clone the repository and install with uv:

git clone https://forge.marvin8.zone/marvin8/yilan
cd yilan
uv sync

Or install directly from the repository:

uv tool install git+https://forge.marvin8.zone/marvin8/yilan

Forgejo API token

Yilan fetches commit history and open issues via the Forgejo API. Without a token the board still renders but API fields show (unavailable — no token).

1. Go to Settings → Applications → Access Tokens on forge.marvin8.zone.
2. Create a token with at minimum the issue and repository read scopes.
3. Export it in your shell profile:

export FORGE_TOKEN=your_token_here

Or pass it inline for a one-off run:

FORGE_TOKEN=... yilan

Verify the install

yilan --version