Skip to content

grainulation/mill

Mill

npm version npm downloads license node CI Explore on DeepWiki

Turn sprint evidence into shareable artifacts.

26 export formats. PDF, CSV, Markdown, slides, JSON-LD, Jira, GitHub Issues, and more. Give mill your claims or HTML output and it produces whatever your team needs.

Install

npm install -g @grainulation/mill

Or use directly:

npx @grainulation/mill export --format csv claims.json

Quick start

# Claims to CSV
mill export --format csv claims.json

# HTML brief to PDF
mill export --format pdf output/brief.html

# HTML to clean Markdown
mill convert --from html --to markdown output/brief.html

# Claims to JSON-LD
mill export --format json-ld claims.json -o claims.jsonld

# Build a static site from sprint outputs
mill publish --target static output/

# Copy to clipboard
mill publish --target clipboard output/brief.html

Export formats

26 built-in formats:

Format Input Output
pdf HTML, Markdown PDF
csv claims.json CSV
markdown HTML Markdown
json-ld claims.json JSON-LD (schema.org)
html-report claims.json Interactive HTML report
slide-deck claims.json Scroll-snap HTML presentation
github-issues claims.json GitHub Issues JSON payloads
jira-csv claims.json Jira-compatible CSV import
yaml claims.json YAML
ndjson claims.json Newline-delimited JSON
dot claims.json Graphviz DOT
graphml claims.json GraphML
bibtex claims.json BibTeX citations
ris claims.json RIS citations
rss claims.json RSS feed
opml claims.json OPML outline
obsidian claims.json Obsidian vault
sql claims.json SQL INSERT statements
typescript-defs claims.json TypeScript type definitions
executive-summary claims.json Executive summary HTML
evidence-matrix claims.json Evidence tier matrix
changelog claims.json Sprint changelog
sankey claims.json Sankey diagram data
treemap claims.json Treemap data

Run mill formats to see the full list with descriptions.

Publish targets

Target Output
static Dark-themed static site in _site/
clipboard System clipboard (pbcopy/xclip/clip)

CLI

mill export    --format <fmt> <file>              Export to target format
mill convert   --from <fmt> --to <fmt> <file>     Convert between formats
mill publish   --target <dest> <dir>              Publish sprint outputs
mill formats                                      List available formats
mill serve     [--port 9094] [--source <dir>]     Start the export workbench UI
mill serve-mcp                                    Start the MCP server on stdio

All commands accept -o <path> to set the output location.

Works standalone

Mill reads sprint output files directly. It does not require wheat -- give it HTML, Markdown, or claims JSON and it produces shareable formats.

Zero third-party dependencies

Depends only on @grainulation/barn (internal ecosystem utilities); no third-party runtime deps. Node built-ins otherwise. Heavy operations (PDF) run via npx on demand.

Part of the grainulation ecosystem

Tool Role
wheat Research engine -- grow structured evidence
farmer Permission dashboard -- approve AI actions in real time
barn Shared tools -- templates, validators, sprint detection
mill Format conversion -- export to PDF, CSV, slides, 26 formats
silo Knowledge storage -- reusable claim libraries and packs
harvest Analytics -- cross-sprint patterns and prediction scoring
orchard Orchestration -- multi-sprint coordination and dependencies
grainulation Unified CLI -- single entry point to the ecosystem

Releases

See CHANGELOG.md for release history.

License

MIT

About

Export engine for structured claims. Markdown, CSV, JSON, HTML, PDF. MCP server included.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors