Quick Start

1. Create a config file

Yilan reads ~/.config/yilan/config.toml by default. Create the file and add the Codeberg accounts you want to track:

[owners]
accounts = ["your-username", "your-org-name"]

That's the minimum config needed. Yilan will discover all non-fork, non-archived repos for each account automatically.

2. Run yilan

export CODEBERG_TOKEN=your_token_here
yilan

Yilan fetches data, writes BOARD.md in the current directory, and prints a summary to stderr:

Fetched 12 repos, 0 concepts. Clean run.

3. Read the board

Open BOARD.md. Each repo appears as a section with:

• Last — date and message of the most recent commit
• Open issues — list of open issue numbers and titles
• Outstanding — headings from intent files that still have open items
• Packages — (monorepos only) per-package name, version, and description

Repos with activity (issues or outstanding items) are sorted to the top.

4. Run the diff

After a second run you can see what changed:

yilan diff

Output shows new commits, opened/closed issues, and changes to outstanding headings.

5. Next steps

• See Command Reference for all flags.
• See Configuration for the full config.toml schema.
• See Intent Files to understand how yilan reads your roadmap.md, TODO.md, and other tracking files.