chartworks
v0.0.3
Published
Chartworks CLI — render charts, fetch the agent manual, look up chart guides. https://chartworks.dev
Maintainers
Readme
chartworks
Command-line interface for Chartworks — render charts and fetch the agent manual / per-chart guides from a terminal or any agent shell.
Status
v0.0.2 is the first functional release. All four commands (manual, guide, render, presets) hit the live API at https://chartworks.dev. Content is fetched on every call — nothing is bundled, so guides can't drift while Chartworks evolves. Surface tracks os/agent-experience.md Surface 3 in the monorepo.
Install
No install needed:
npx chartworks --helpOr global:
npm install -g chartworks
chartworks --helpCommands
chartworks manual # stage 1: orientation, once per session
chartworks guide bar line # stage 2: per-chart spec + examples (variadic)
chartworks render --spec spec.json # stage 3: render to PNG/SVG
cat spec.json | chartworks render # stdin works too
chartworks presets # list available presetsOutput: manual, guide, and presets write Markdown to stdout (or JSON with --json). render writes the image to --out (default: chart.png / chart.svg) and prints the absolute path on stdout.
Flags: --api-url, --json, --out, --format, --scale, --help, --version.
Why a CLI
MCP and the HTTP API are the two existing surfaces. The CLI is the third — thin wrapper over the API, no state, designed for coding agents that drive work through bash. See os/agent-experience.md for the full design.
