CLI Reference

The draft CLI is the primary tool for working with Draft projects.

Commands

draft new

Create a new Draft project:

draft new <name> [options]

Options:

--template <name> — Project template (default, web, embedded, mobile, game)
--path <path> — Directory to create project in

draft new my-app
draft new my-app --template web
draft new my-app --template embedded

draft build

Compile a Draft project:

draft build [options]

Options:

--target <target> — Compilation target (native, wasm, wasi)
--release — Release build (optimized)
--debug — Debug build
--output <path> — Output path
--lib — Build as library
--minify — Minify output
--compress — Compress output
--source-map — Generate source map

draft build
draft build --release
draft build --target wasm
draft build --target wasm --minify
draft build --output my-app

draft run

Compile and run a Draft program:

draft run <file> [options]

Options:

--target <target> — Runtime target
--release — Release build
--args <args> — Arguments to pass to program

draft run main.draft
draft run main.draft --release
draft run main.draft --args "arg1 arg2"

draft test

Run tests:

draft test [options]

Options:

--target <target> — Test target
--filter <pattern> — Filter tests by name
--release — Release build
--watch — Watch for changes and re-run

draft test
draft test --filter "test_add"
draft test --watch

draft fmt

Format Draft source files:

draft fmt [options] [files]

Options:

--check — Check formatting without changes
--diff — Show formatting diff

draft fmt
draft fmt src/
draft fmt --check
draft fmt main.draft

draft check

Check code for errors without compiling:

draft check [options]

Options:

--warnings — Show warnings

draft check
draft check --warnings

draft clean

Remove build artifacts:

draft clean

draft doc

Generate documentation:

draft doc [options]

Options:

--output <path> — Output directory
--open — Open docs in browser

draft doc
draft doc --output docs/
draft doc --open

draft deps

Manage dependencies:

draft deps <command>

Commands:

install — Install dependencies
update — Update dependencies
list — List dependencies
search <query> — Search for packages

draft deps install
draft deps update
draft deps list
draft deps search http

draft add

Add a dependency:

draft add <package> [version]

draft add http
draft add http 1.2.0
draft add json --features serde

draft remove

Remove a dependency:

draft remove <package>

draft publish

Publish a package:

draft publish [options]

Options:

--dry-run — Simulate publish
--registry <url> — Registry URL

draft package

Create a package:

draft package [options]

draft init

Initialize a new package in current directory:

draft init [options]

draft target

Manage compilation targets:

draft target <command>

Commands:

list — List installed targets
add <target> — Add a target
remove <target> — Remove a target
available — List available targets

draft target list
draft target add wasm
draft target add arm-none-eabi
draft target available

draft run

Run a compiled program:

draft run <binary>

draft flash

Flash to embedded device:

draft flash [options]

Options:

--target <target> — Target platform
--probe <probe> — Debug probe

draft flash
draft flash --target thumbv7em-none-eabihf

draft debug

Start debugging session:

draft debug [options]

Options:

--gdb — Use GDB
--lldb — Use LLDB
--swo — Enable SWO trace

draft debug
draft debug --gdb

draft deploy

Deploy application:

draft deploy [options]

Options:

--target <target> — Deployment target

draft deploy
draft deploy --target web
draft deploy --target ios

draft upgrade

Upgrade Draft installation:

draft upgrade

draft version

Print version information:

draft version
draft --version
draft -V

draft help

Show help:

draft help
draft help <command>
draft --help
draft -h

draft completion

Generate shell completions:

draft completion <shell>

Supported shells: bash, zsh, fish, powershell, elvish

draft completion bash > /etc/bash_completion.d/draft

Global Options

--verbose / -v — Verbose output
--quiet / -q — Quiet output
--color <when> — Color output (auto, always, never)
--config <path> — Config file path

Configuration

draft.toml

[package]
name = "my-app"
version = "0.1.0"
edition = "2024"
authors = ["Your Name <you@example.com>"]
description = "My Draft application"
license = "MIT"

[dependencies]
http = "1.2.0"
json = { version = "1.0", features = ["serde"] }

[profile.release]
opt-level = 3
lto = true

Environment Variables

Variable	Description
`DRAFT_HOME`	Draft installation directory
`DRAFT_TARGET`	Default compilation target
`DRAFT_LOG`	Log level
`DRAFT_REGISTRY`	Package registry URL

Exit Codes

Code	Meaning
0	Success
1	General error
2	Compilation error
3	Runtime error
4	Configuration error
5	I/O error