Skip to content

Yilan

Yilan is a command-line tool that builds a unified markdown project status board across all your active Codeberg repositories.

Run yilan and it fetches the latest commit, open issues, and outstanding items from intent files (roadmap.md, TODO.md, etc.) in each repo, then writes a single BOARD.md you can open alongside your editor.

Features

  • Unified view — one board for all your repos and concepts, sorted by activity
  • Intent files — surfaces outstanding headings from roadmap.md, TODO.md, improvements.md, security-audit.md, and NOTES.md
  • Monorepo support — expands packages/ subdirectories and per-package intent files
  • Concepts — tracks idea/design documents from a local directory or a remote repo
  • SHA-based cache — avoids redundant fetches; re-fetches only when a repo's HEAD changes
  • Diff view — yilan diff shows what changed since the last board update
  • Dry-run mode — --dry-run prints the board to stdout without writing the file

Quick example

export CODEBERG_TOKEN=your_token_here
yilan

BOARD.md is updated in the current directory.

# Show what changed since the last run
yilan diff

# Print to stdout without saving
yilan --dry-run

Installation

uv tool install git+https://codeberg.org/marvin8/yilan

See Installation and Quick Start for full setup instructions.