Skip to content

Repository files navigation

Mill

npm versionnpm downloadslicensenodeCIExplore 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:

FormatInputOutput
pdfHTML, MarkdownPDF
csvclaims.jsonCSV
markdownHTMLMarkdown
json-ldclaims.jsonJSON-LD (schema.org)
html-reportclaims.jsonInteractive HTML report
slide-deckclaims.jsonScroll-snap HTML presentation
github-issuesclaims.jsonGitHub Issues JSON payloads
jira-csvclaims.jsonJira-compatible CSV import
yamlclaims.jsonYAML
ndjsonclaims.jsonNewline-delimited JSON
dotclaims.jsonGraphviz DOT
graphmlclaims.jsonGraphML
bibtexclaims.jsonBibTeX citations
risclaims.jsonRIS citations
rssclaims.jsonRSS feed
opmlclaims.jsonOPML outline
obsidianclaims.jsonObsidian vault
sqlclaims.jsonSQL INSERT statements
typescript-defsclaims.jsonTypeScript type definitions
executive-summaryclaims.jsonExecutive summary HTML
evidence-matrixclaims.jsonEvidence tier matrix
changelogclaims.jsonSprint changelog
sankeyclaims.jsonSankey diagram data
treemapclaims.jsonTreemap data

Run mill formats to see the full list with descriptions.

Publish targets

TargetOutput
staticDark-themed static site in _site/
clipboardSystem 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

ToolRole
wheatResearch engine -- grow structured evidence
farmerPermission dashboard -- approve AI actions in real time
barnShared tools -- templates, validators, sprint detection
millFormat conversion -- export to PDF, CSV, slides, 26 formats
siloKnowledge storage -- reusable claim libraries and packs
harvestAnalytics -- cross-sprint patterns and prediction scoring
orchardOrchestration -- multi-sprint coordination and dependencies
grainulationUnified 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

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors

Languages