Command reference

Each command has its own page with its options and examples. Run curvenote <command> --help for the same list on your command line; cn works anywhere curvenote does.

Write and preview

CommandWhat it does
curvenote initSet up a project in a folder, or start one from GitHub or Curvenote.
curvenote startServe the project as a website that reloads as you write.
curvenote buildBuild PDF, LaTeX, Typst, Word, JATS, MECA and site exports.
curvenote cleanRemove exports, caches, downloaded templates and temporary files.
curvenote checkRun a venue’s checks on the project before you submit.

Publish

CommandWhat it does
curvenote deployDeploy the project as a site on curve.space or your domain.
curvenote workPush a work or a new version of it, list or register works.
curvenote submitSubmit the work to a venue.
curvenote submissionList, publish and unpublish submissions.
curvenote siteSet up the content of a site you manage.

Account

CommandWhat it does
curvenote tokenSign in with an API token, switch accounts, or sign out.

Projects from the Curvenote editor

CommandWhat it does
curvenote cloneCopy a project from the Curvenote editor into a local folder.
curvenote pullBring a cloned project up to date with the editor.

Options for every command

  • -v, --version: print the version of the CLI.

  • -d, --debug: log every step and the full text of any error. Add it when a command fails and include the output when you report an issue.

  • -h, --help: print the help for the CLI or for a command, as in curvenote build --help.

Commands that publish need you to be signed in. Commands that prompt you accept -y or --yes to take the default answer, which is how you run them in continuous integration.

Abbreviations
API
Application Programming Interface
CLI
Command Line Interface
JATS
Journal Article Tag Suite
PDF
Portable Document Format