View as markdown

hive wiki

Manages a project’s LLM-maintained wiki changelog. Its one subcommand rebuilds wiki/log.md from the individual change fragments under wiki/log.d/*.md. Reach for it after a merge or rebase to refresh the compiled changelog, or to check that the changelog is up to date.

Usage

hive wiki compile-log [PROJECT_PATH] [--check]

PROJECT_PATH defaults to the current directory, which must contain a wiki/ directory.

Subcommands and options

Command What it does
hive wiki compile-log Regenerate wiki/log.md for the current project.
hive wiki compile-log PATH Regenerate the changelog for another checkout.
hive wiki compile-log --check Don’t write anything; exit non-zero if wiki/log.md is stale.

How it works

Each wiki change adds a uniquely named fragment under wiki/log.d/, for example wiki/log.d/20260605-220000-short-topic.md. The compiler reads those fragments, sorts them, and writes a regenerated section into wiki/log.md, leaving older legacy entries below it. Running it again is idempotent — it won’t duplicate entries.

Adding fragments instead of editing wiki/log.md directly is what keeps concurrent changes from conflicting on one shared file. Use the mutating compile-log for cleanup after merges or rebases, and prefer --check for verification.

Examples

# Rebuild the changelog for the current project
hive wiki compile-log

# Verify the changelog is current (e.g. in CI), without writing
hive wiki compile-log --check