Skip to content

Command Reference

Synopsis

yilan [OPTIONS] [SUBCOMMAND]

Options

--output PATH

Write the board to PATH instead of the default (BOARD.md or the path configured in config.toml).

yilan --output ~/status/board.md

--dry-run

Print the rendered board to stdout instead of writing a file. No snapshot is saved; the cache is still updated.

yilan --dry-run | less

--no-cache

Disable the SHA-based cache for this run. Every repo is fetched fresh regardless of whether its HEAD has changed.

yilan --no-cache

--overview

Prepend an Overview section to the board. The overview lists only repos and concepts that have activity (open issues, outstanding headings, or open todo items) in a compact one-line format.

yilan --overview

--concepts-dir PATH

Look for concept documents in PATH instead of the directory configured in config.toml. Expects a directory where each subdirectory is a concept name containing a README.md or concept.md.

yilan --concepts-dir ~/notes/concepts

--concepts-repo OWNER/REPO

Fetch concept documents from a remote Codeberg repo instead of a local directory. Takes precedence over --concepts-dir.

yilan --concepts-repo myorg/my-concepts

--config PATH

Load configuration from PATH instead of ~/.config/yilan/config.toml. The environment variable YILAN_CONFIG is an alternative.

yilan --config /path/to/other-config.toml
# or
YILAN_CONFIG=/path/to/other-config.toml yilan

--version

Print the installed version and exit.

yilan --version

Subcommands

diff

Show what changed in each repo and concept since the last board update.

yilan diff

Reads the snapshot saved by the previous yilan run, fetches current data, and prints a markdown diff to stdout. Exit code 1 if any fetch errors occurred.

The diff reports for each repo:

  • New commits (before → after message)
  • Issues opened or closed
  • Outstanding headings added or removed
  • Change in open todo count

Environment variables

Variable Purpose
CODEBERG_TOKEN API token for authenticated requests
YILAN_CONFIG Path to the config file (overridden by --config)

Exit codes

Code Meaning
0 Success, no fetch errors
1 One or more repos/concepts returned an error