All apps/west

west

west

Zephyr Project meta-tool.

Runs as west|macOS, Linux, Windows|docs.zephyrproject.org

Command form

ai-draft · 4 tasks · 16 fields

Common west jobs: create a workspace, update projects, build a Zephyr application. Flash, debug, sysbuild and CMake pass-through arguments are not covered.

Opens the form; the finished command lands at your prompt, unrun
otty gui west

west init

Create a workspace

Clone a manifest repository into a new west workspace.

Create a workspaceExample values, fixed in this page — nothing here reaches a terminal
Basic
Manifest repository URL
url
Manifest revision
string
Directory*
directory
TasksEach one presets the form for one job
Clone a manifest
manifest_urlmanifest_revdirectory
ParametersOnly these flags are editable in the form
Manifest repository URL
url
-m
Manifest revision
string
--mr
Manifest file
string
--mf
Use an existing local manifest repository
boolean
-l
Directory
path · positional 0

west update

Update projects

Update the projects listed in the manifest.

Update projectsExample values, fixed in this page — nothing here reaches a terminal
TasksEach one presets the form for one job
Update all projects
ParametersOnly these flags are editable in the form
Fetch policy
enum
-falwayssmart
Keep descendant branches
boolean
-k
Rebase instead of detaching
boolean
-r
Print statistics
boolean
--stats
Projects
string · positional 0 · repeatable

west build

Build an application

Build a Zephyr application for a board.

Build an applicationExample values, fixed in this page — nothing here reaches a terminal
Basic
Board*
string
Source directory
directory
TasksEach one presets the form for one job
Build for a board
boardsource_dir
Pristine build
boardpristinesource_dir
ParametersOnly these flags are editable in the form
Board
string
-b
Build directory
path
--build-dir-d
Build target
string
-trunpristinehelp
Pristine build
boolean
-p
Force CMake re-run
boolean
-c
Source directory
path · positional 0
SourcesEvery flag above is checked against these
docs
west init [-m URL] [--mr REVISION] [--mf FILE] [directory] west init -l [--mf FILE] directory west init -m https://github.com/zephyrproject-rtos/zephyr --mr v1.14.0 zp
manual2026-10-27

docs.zephyrproject.org

docs
west update [-f {always,smart}] [-k] [-r] [--group-filter FILTER] [--stats] [PROJECT ...]
manual2026-10-27

docs.zephyrproject.org

docs
west build -b <BOARD> path/to/source/directory west build -b <BOARD> --build-dir path/to/build/directory west build -b qemu_x86 -t run samples/hello_world west build -p -b reel_board samples/hello_world west build -p=always -b reel_board samples/hello_world west build -c
manual2026-10-27

docs.zephyrproject.org

Before it fills your prompt, Otty checks the installed west against its version. A form that does not match your version is not offered.