@popcraft/cli

The popcraft command line: PopCraft from a terminal, a CI job or an AI agent. It runs the same commands the editor, its agent and plugins run, on .popcraft files, cloud files and the desktop app.

brew install getpopcraft/popcraft/popcraft   # one executable, no Node needed
npm i -g @popcraft/cli          # or from npm: Node 25 or newer
npm i -g puppeteer              # optional: renders and exports
popcraft new poster.popcraft --name Poster
popcraft run poster.popcraft write_design --size ig-post --script @poster.js
popcraft run poster.popcraft export.nodes --format PNG --out poster.png
popcraft --help

Designs written as scripts use the design kit, @popcraft/kit, which this package depends on; install it in your project too for types while you write them.

Examples

In getpopcraft/examples: a launch in three sizes from one script, translated copies of a design.

Documentation

• Command line: every subcommand and flag.
• Designing with an AI agent and the design reference.
• Packages: what each PopCraft package is for.

Release notes: CHANGELOG.md.