agent-publish — Launch Thread

I built a CLI that turns markdown into styled HTML and pushes to GitHub Pages. One command, runs offline, no API tokens.

Just Python on your machine. Nothing phones home.

The repo: github.com/thisisprabha/agent-publish

3 themes, dark mode, auto TOC, RSS feeds, Mermaid diagrams, Open Graph tags. Everything happens on your machine.

I kept running overnight research, getting markdown back, then wasting 20 minutes making it not look like a raw dump.

agent-publish publish research.md does MD → HTML → git push. Done.

Weirdest feature: DESIGN.md portable themes.

You write your theme as markdown (typography, colors, spacing). The converter turns it into CSS at build time. So your theme IS the documentation. Git-diffable, readable, no .css files to maintain.

Also in there:

• --humanize rewrites AI-generated text through an LLM before converting. Output reads like a person wrote it
• Anti-slop checker that catches marketing phrases (--strict to hard-fail)
• --skill briefing loads different output templates
• OKLch color palettes from a single --direction flag

Install:

git clone https://github.com/thisisprabha/agent-publish.git
cd agent-publish
pip install -e .

Then:

agent-publish publish your-file.md \
  --url https://you.github.io/repo

Python 3.10+. That's it. No accounts, no keys, no config needed.

MIT licensed. There's a kanban in KANBAN.md if you want to pick something up.

If you publish agent outputs or research notes, try it and lmk what breaks.