Command reference
Every CLI command and its flags on one page.
webmati help lists every command of the build you have; webmati <command> --help explains one. This table matches that help (a test keeps it complete).
Flags for every command
| Flag | Effect |
|---|---|
--json | machine-readable output |
--dir DIR | run as if inside the folder DIR |
--verbose | print every HTTP request (never a key or a body) |
Commands
| Command | Does | Main flags |
|---|---|---|
webmati login | store a key for a website (approve in the browser, or paste a key) | --web --platform --store --key --days --label --locale --api --admin |
webmati logout | forget a stored key | --platform --store --api |
webmati create "<name>" [folder] | create a new website (in the browser, or with a workspace key) and clone it | --slug --template --key --platform --days --label --locale --api --admin |
webmati clone <website> [folder] | create a project from a website and pull it | --platform --target --theme-id --api --admin |
webmati pull [path…] | take server changes, merging when it can | |
webmati status [path…] | what changed here and on the server | --offline |
webmati diff [path…] | a diff of your changes (or against the server) | --remote --at --since |
webmati push [path…] | send your changes to the drafts, and the project's own files | --dry-run --live --allow-destructive --yes --force --no-validate -m --note --allow-mass-delete |
webmati resolve <path> | settle a conflict | --ours --theirs --merged |
webmati merge [path…] | merge open conflicts again, or undo the automatic merges | --abort |
webmati history [path] | who changed the project's own files, when and why (one snapshot per push); a workflow's published versions | --limit |
webmati restore <path>… --at <n> | bring files back here as snapshot n held them (then push) | --at |
webmati validate [path…] | run the server's rules on your machine | --remote --all |
webmati preview | print a link to the draft | --path --ttl --open |
webmati dev | push theme changes as you save; a preview that reloads | --port --path --open --new-theme --theme-name --no-proxy --debounce --ttl --app --no-app-build |
webmati test [workflow] | run a workflow draft here, against backend/fixtures | --input --node --remote --yes --allow-network --timeout |
webmati publish theme | workflow <code> | make the draft live | --yes |
webmati domain list | add | verify | ssl | primary | remove | the website's own domains: DNS records, verification, HTTPS, primary address | --wait --timeout --cert-file --key-file --yes --store --api |
webmati app deploy | list | versions | rollback | route | unroute | rm | a built JavaScript app (React/Vite dist/): deploy it, its versions and rollback, the routes its router owns | --dist --manifest --note --no-activate --page --yes |
webmati worker deploy | upload | list | rm | a background-job worker (Go → WebAssembly): build it, upload it, declare it on the website; upload --app for an app's worker | --code --app --memory-mb --timeout-s --concurrency --egress --tables --yes --store --api |
webmati add react-app [name] | scaffold a React + Vite app in app/ and the page that mounts it | --route --page --into |
webmati files ls | restore <n> | the project's own files on the server: the list; put a whole earlier set back | --yes --dry-run |
webmati issue new | list | show | vote | comment | report a platform bug or request (it looks for the same one first), +1 one, follow it | --kind --area --title --body --body-file --attach-last --yes --mine --status --q --sort --limit --private --note --remove --store --api |
webmati tool list | describe | call | call any platform tool | --json --args --select --compact --limit --store --api |
webmati mcp | serve the slim MCP on stdio | --full --allow-destructive --allow-local-files --measure |
webmati exec <file.ts|-> | run a code-mode script | --allow-writes --allow-destructive --allow-network --allow-local-files --max-calls --timeout |
webmati sdk | write the tool docs to .webmati/sdk | --out |
webmati skills | the platform's playbooks in .webmati/skills and the facts in .webmati/reference; refresh them or the project's AGENTS.md files | --refresh --update-instructions --yes |
webmati update | update the CLI now | --check --version --off --on |
webmati version | build information |
Environment variables
| Variable | Effect |
|---|---|
WEBMATI_TOKEN | a key to use instead of the saved one (CI) |
WEBMATI_PLATFORM | the default platform outside a project (webmati) |
WEBMATI_API_BASE, WEBMATI_ADMIN_URL | the API / admin address outside a project |
WEBMATI_CONFIG_DIR | where keys and settings live (default ~/.config/webmati) |
WEBMATI_NO_AUTO_UPDATE=1 | never update automatically |
WEBMATI_SECRET_<CODE> | a secret value for webmati test |
Exit codes
0 done · 1 error · 2 bad usage · 3 needs your attention (conflicts,
validation errors, refused changes) · 4 the CLI is too old (webmati update).