@x12i/reportix-composer-cli

Command-line interface for Reportix Composer. Renders Markdown to PDF, DOCX, PPTX, or HTML and manages templates.

Install

npm install -g @x12i/reportix-composer-cli
# or one-shot:
npx @x12i/reportix-composer-cli --help

PDF export needs Playwright Chromium once:

npx playwright install chromium

Render

reportix-composer render --in report.md --template clean-report --format pdf --out report.pdf
reportix-composer render --in report.md --template clean-report --format docx
reportix-composer render --in report.md --template clean-report --format pptx
reportix-composer render --in report.md --template letter --format html --out report.html

| Option | Description | | --- | --- | | --in <file> | Input Markdown file (required) | | --template <id> | Template id (required) | | --format <pdf\|docx\|html\|pptx> | Output format (default pdf) | | --out <file> | Output path (default: same name as input with new extension) | | --templates-dir <dir> | Override user templates directory | | --assets-dir <dir> | Override image assets directory |

Templates

reportix-composer templates list
reportix-composer templates show clean-report
reportix-composer templates create-from-html --id my-layout --name "My Layout" --layout layout.html --styles styles.css
reportix-composer templates create-from-image --id from-shot --name "From Shot" --image design.png
reportix-composer templates delete my-layout

create-from-image requires ANTHROPIC_API_KEY (or --anthropic-api-key).

Image assets

reportix-composer assets add ./logo.png --token brand-logo
reportix-composer assets list
reportix-composer assets remove brand-logo

Reference uploaded assets in Markdown / frontmatter as {{image:brand-logo}}.

Environment variables

| Variable | Purpose | | --- | --- | | REPORTIX_COMPOSER_TEMPLATES_DIR | User templates directory (default ~/.reportix-composer/templates) | | REPORTIX_COMPOSER_ASSETS_DIR | Image assets directory (default ~/.reportix-composer/assets) | | ANTHROPIC_API_KEY | For AI template creation from images |

Programmatic alternative

Prefer @x12i/reportix-composer-core when embedding rendering in your own Node.js app.