Home

stencila

CLI subcommands and global options

Usage

stencila [OPTIONS] [COMMAND]

Examples

# Get help on all available commands
stencila --help

# Create a new document
stencila new article.md

# Convert a document to another format
stencila convert input.md output.pdf

# Check available formats
stencila formats list

# Execute a document
stencila execute notebook.myst

# Open a document in the browser
stencila open document.md

Subcommands

CommandDescription
newCreate a new, tracked, document
initInitialize a workspace with stencila.toml configuration
configManage Stencila configuration
statusGet the tracking status of documents
moveMove a tracked document
trackStart tracking a document
untrackStop tracking a document
cleanClean the current workspace
convertConvert a document to another format
mergeMerge changes from another format
syncSynchronize a document between formats
pushPush content to Stencila Cloud and remote services
pullPull a document from a remote service
watchEnable automatic sync for the workspace or a document
unwatchDisable automatic sync for the workspace or a document
compileCompile a document
lintLint one or more documents
executeExecute a document
renderRender a document
queryQuery a workspace database
openOpen a document in the browser
publishPublish one or more documents
demoRun a terminal demonstration from a document
outputsManage workspace outputs
dbManage the workspace database
workflowsManage workflow definitions
agentsManage agent definitions
skillsManage agent skills
modelsManage and interact with generative AI models
kernelsManage execution kernels
lintersManage linters
formatsList and inspect supported formats
themesManage themes
promptsManage prompts
mcpManage MCP (Model Context Protocol) servers
toolsManage tools and environments used by Stencila
secretsManage secrets
authManage OAuth authentication for AI model providers
serveRun the HTTP/Websocket server
snapCapture screenshots and measurements of documents served by Stencila
lspRun the Language Server Protocol server
cloudManage Stencila Cloud account
siteManage the workspace site
signinSign in to Stencila Cloud
signoutSign out from Stencila Cloud
logsDisplay logs from Stencila Cloud workspace sessions
upgradeUpgrade to the latest version
uninstallUninstall this command line tool

Options

NameDescription
--no-previewDo not serve a preview of the workspace site. Possible values: true, false.
-h, --helpPrint help: -h for brief help, --help for more details. Possible values: true, false.
--yesAssume the answer yes to any interactive prompts. Possible values: true, false.
--debugDisplay debug level logging and detailed error reports. Possible values: true, false.
--no-colorDo not color any output.
© 2026 Stencila