The complete command surface, one page per command. Everything below is emitted by the binary itself (colophon --help), so it always matches the release it was generated from.
- colophon init — Scaffold a new colophon project
- colophon new — Scaffold a new post (dated, chronological) (subcommands: post, page)
- colophon build — Build the site into public/ (prints next pending embargo)
- colophon next-build-time — Print the next pending publish_after timestamp (for CI scheduling)
- colophon serve — Serve every environment locally with live reload
- colophon publish — Build and deploy/mirror to publishers (gated)
- colophon themes — List the built-in themes (subcommands: list, eject)
- colophon authors — List authors (the bylines) (subcommands: list, show)
- colophon persona — List personas (subcommands: list, context)
- colophon sources — Show where content lives and how posts are marked publishable
- colophon posts — List content entries (for editing and cross-referencing)
- colophon search — Search content (lexical or semantic)
- colophon skills — Show which agent harnesses are present and the install status of each skill (subcommands: detect, install, list, uninstall)
- colophon webmention — Notify the sites your live posts link to (run after publish) (subcommands: send, fetch, publish)
- colophon syndicate — Cross-post (POSSE) to the environment's configured syndicators
- colophon doctor — Validate the project config and report problems
- colophon env — List the environment variables this project uses
colophon --help
Usage: colophon <command> [flags]
A themed Markdown blog generator with pluggable publishers
Flags:
-h, --help Show context-sensitive help.
--version Print version and exit
Commands:
init [<dir>] [flags]
Scaffold a new colophon project
new post <title> [flags]
Scaffold a new post (dated, chronological)
new page <title> [flags]
Scaffold a new standing page (nav menu, no date)
build [flags]
Build the site into public/ (prints next pending embargo)
next-build-time [flags]
Print the next pending publish_after timestamp (for CI scheduling)
serve [flags]
Serve every environment locally with live reload
publish --env=ENV,... [flags]
Build and deploy/mirror to publishers (gated)
themes list
List the built-in themes
themes eject <name> [flags]
Copy a built-in theme into themes/<name>/ to customise
authors (author) list [flags]
List authors (the bylines)
authors (author) show <author> [flags]
Show one author's full details
persona (personas) list [flags]
List personas
persona (personas) context [<persona>] [flags]
Emit style guide + top-K exemplars for AI-assisted writing
sources (source) [flags]
Show where content lives and how posts are marked publishable
posts (post) [flags]
List content entries (for editing and cross-referencing)
search [<query>] [flags]
Search content (lexical or semantic)
skills detect [flags]
Show which agent harnesses are present and the install status of each skill
skills install [flags]
Install/update the skills into detected harnesses (or --harness/--dir)
skills list
List the skills embedded in this binary
skills uninstall [flags]
Remove colophon-managed skills from detected harnesses (or --harness/--dir)
webmention send [flags]
Notify the sites your live posts link to (run after publish)
webmention fetch [flags]
Pull received mentions from the configured receiver into the local cache
webmention publish [flags]
Fetch mentions and deploy only _mentions/ (refresh responses without a full
re-upload)
syndicate [flags]
Cross-post (POSSE) to the environment's configured syndicators
doctor [flags]
Validate the project config and report problems
env [flags]
List the environment variables this project uses
Run "colophon <command> --help" for more information on a command.