The XenoKit app runs nothing itself: it drives the xenokit command-line tool inside it. Everything the app does, you can do from Terminal, a CI job or an AI coding agent, and a project behaves the same way from all of them. Install the tool from App Settings›Command Line.
Everyday commands
Run these inside a project folder:
$ xenokit status . # files with errors or warnings now
$ xenokit run --file <path> # compile one file now (a Sass partial: the files that import it)
$ xenokit log --failed --full # a failed run's command, tool versions and full output
$ xenokit file <path> # how one file compiles, and where each setting comes from
$ xenokit validate # check .xenokit.yml, with line numbers
$ xenokit watch # watch this project until Ctrl-CWhen the app, or another xenokit watch, is already watching the project, xenokit run hands the run to that watcher instead of starting a second one.
Projects
These are the lifecycle commands shared by every XenoTool:
$ xenokit add [<folder>] # set up a new project: write .xenokit.yml and add it
$ xenokit import [<folder>] # set up a project CodeKit has
$ xenokit list # the projects in XenoKit, and whether each is watched
$ xenokit enable|disable <name> # watch a project while the app is open, or stop
$ xenokit remove <name> # take a project out of XenoKit; its folder is untouched
$ xenokit export <name> --to <file>
$ xenokit restore [<folder>] [--from <file>]xenokit add --dry-run lists the folders and suggestions without writing anything.
Tools
$ xenokit tools # installed versions, this Mac's selection, updates
$ xenokit tools install sass # the latest Dart Sass (or name a version)
$ xenokit tools pin sass 1.104.1 --project .
$ xenokit tools try sass 2.0.0 --project . # compile with a new version beside the current one and compare
$ xenokit doctor # tools, PATH, .gitignore and stale watcher filesLicense
Watching needs a license or the 14-day trial, which starts the first time the XenoKit app opens. Everything else works without one, xenokit run included, so CI jobs and AI coding agents keep building. See Licensing.
$ xenokit license # this Mac's license or trial, and whether it can watch
$ xenokit license activate <key> # use one of the license's seats
$ xenokit license seats # the Macs using it; release <seat-id> frees one
$ xenokit license deactivate # free this Mac's seat, keeping the keyWithout a license or a running trial, xenokit watch exits 11, and a watcher that is already running stops at its next change.
--json and --dry-run
- Every command takes
--json. Each output line has atype, keys are snake_case, dates are ISO 8601 and paths are absolute. A failure ends with an error line carryingcode,what,whyandnext. - Every command that changes something takes
--dry-run: it checks what the real run would refuse and says what it would do, without changing anything.
Exit codes
- 0
- Success
- 2
.xenokit.ymlor XenoKit’s project list is invalid or can’t be read- 3
- A required tool is missing
- 4
- The tool registry, the license server or a watcher didn’t answer
- 5
validateordoctorfound problems- 6
- A watcher already owns the project
- 7
- Refused, with nothing changed (also a key the license server refused, or every seat taken)
- 9
- Failed, and nothing was left changed
- 10
- Failed and left a change that couldn’t be taken back
- 11
- Watching without a license or a running trial
- 64
- A mistake in the command line
- 124
- Timed out
- 130
- Interrupted
xenokit run otherwise exits with the command’s own status. Without --json, errors are printed as What / Why / Next, with the exit code on the first line.
Help for every key
xenokit schema lists every key .xenokit.yml accepts and what each one takes. xenokit validate rejects unknown keys and suggests the closest valid one.