Generated by npm run docs:commands from the command specs. Do not edit by hand.
| Command | Summary | Status |
|---|---|---|
atc start |
Start the server (core, API, web admin) in the background | works |
atc stop |
Stop the server: unload the models, stop the API and the admin | works |
atc restart |
Stop the server if it runs, then start it | works |
atc status |
Show the server, the API endpoint, running models and the admin URL | works |
atc logs |
Show the server log | works |
atc run |
Start a downloaded model on the running server | stub — iteration 2 (a first model answering: engines install, models pull, run, unload, the API) |
atc unload |
Stop a running model and free its memory | stub — iteration 2 (a first model answering: engines install, models pull, run, unload, the API) |
atc models |
The catalog and the model files: search, download, list, remove, describe | group |
atc models search |
Search the curated catalog (and Hugging Face for owner/repo) | stub — iteration 3 (models: catalog, resolver, resumable pull, list, rm, info; API keys) |
atc models pull |
Download a model into the data folder | stub — iteration 2 (a first model answering: engines install, models pull, run, unload, the API) |
atc models list |
Installed models | stub — iteration 3 (models: catalog, resolver, resumable pull, list, rm, info; API keys) |
atc models rm |
Delete an installed model | stub — iteration 3 (models: catalog, resolver, resumable pull, list, rm, info; API keys) |
atc models info |
model.yml, size, capabilities and whether it fits | stub — iteration 3 (models: catalog, resolver, resumable pull, list, rm, info; API keys) |
atc engines |
Engines that run models (llama.cpp, MLX, TensorRT-LLM) and their builds | group |
atc engines list |
Installed engines and builds, the running one, and what is available | stub — iteration 4 (engines and hardware from the core; the managed runtime; elevation) |
atc engines install |
Install an engine (the build the core recommends for this hardware) | stub — iteration 2 (a first model answering: engines install, models pull, run, unload, the API) |
atc engines status |
The running engine and build, driver facts, mismatch warnings | stub — iteration 4 (engines and hardware from the core; the managed runtime; elevation) |
atc engines rm |
Remove an engine build, or the whole engine | stub — iteration 4 (engines and hardware from the core; the managed runtime; elevation) |
atc hardware |
What the core sees of the GPU and CPU | group |
atc hardware show |
GPUs, VRAM, driver, compute capability, CPU extensions | stub — iteration 4 (engines and hardware from the core; the managed runtime; elevation) |
atc hardware refresh |
Probe the hardware again | stub — iteration 4 (engines and hardware from the core; the managed runtime; elevation) |
atc api |
The OpenAI-compatible API and its key | group |
atc api start |
Start the API on the running server | stub — iteration 2 (a first model answering: engines install, models pull, run, unload, the API) |
atc api stop |
Stop the API | stub — iteration 2 (a first model answering: engines install, models pull, run, unload, the API) |
atc api status |
Where the API listens and whether a key is required | stub — iteration 2 (a first model answering: engines install, models pull, run, unload, the API) |
atc api key |
The API key (stored in the core settings) | group |
atc api key show |
Print the key | stub — iteration 3 (models: catalog, resolver, resumable pull, list, rm, info; API keys) |
atc api key set |
Set the key | stub — iteration 3 (models: catalog, resolver, resumable pull, list, rm, info; API keys) |
atc api key rotate |
Generate a new key and restart the API | stub — iteration 3 (models: catalog, resolver, resumable pull, list, rm, info; API keys) |
atc api key clear |
Remove the key (loopback only) | stub — iteration 3 (models: catalog, resolver, resumable pull, list, rm, info; API keys) |
atc admin |
The web admin: open it, see where it listens, manage its token | group |
atc admin open |
Print the admin URL (with a login token) and open it in a browser | works |
atc admin status |
Where the admin listens | works |
atc admin token |
Print the admin token, or make a new one | works |
atc tui |
Full-screen terminal UI over the server (what bare atc opens on a terminal) |
works |
atc config |
Read and change atc settings | group |
atc config get |
Print one value | works |
atc config set |
Set one value in the config file | works |
atc config unset |
Remove one value from the config file (the default applies again) | works |
atc config list |
Every key with its value and where it comes from | works |
atc config path |
Print the config file path | works |
atc doctor |
Check the installation: folders, config, ports, PATH, GPU driver | works |
atc service |
Run the server as an OS service (systemd, launchd, Windows task) | group |
atc service install |
Install and enable the service | stub — iteration 6 (service, update, doctor completion) |
atc service uninstall |
Disable and remove the service | stub — iteration 6 (service, update, doctor completion) |
atc service status |
Whether the service is installed and running | stub — iteration 6 (service, update, doctor completion) |
atc service start |
Start the service | stub — iteration 6 (service, update, doctor completion) |
atc service stop |
Stop the service | stub — iteration 6 (service, update, doctor completion) |
atc update |
Update atc to the latest release | works |
atc version |
Print the atc, core and admin versions | works |
atc completion |
Print a shell completion script (bash, zsh, fish, powershell) | works |
atc host-step exec |
Run one privileged host step from its request file and write the result beside it | works |
Usage: atc start [options]
The server keeps running after this command; `atc stop` ends it. With --foreground it stays in this process instead — for Docker and systemd — and stops on SIGTERM or Ctrl+C.
Options:
--admin Serve the web admin (--no-admin to skip) (default: true)
--admin-port <port> Admin port for this server
--foreground Stay in the foreground (containers, systemd); SIGTERM stops it
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc stop [options]
Stop the server: unload the models, stop the API and the admin
Options:
--force Stop even while other atc commands are attached
--kill After a graceful stop times out, kill the process
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc restart
Stop the server if it runs, then start it
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc status [options]
Show the server, the API endpoint, running models and the admin URL
Options:
--watch Refresh every 2 seconds until interrupted
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc logs [options]
Show the server log
Options:
-n, --lines <count> Lines to show (default: 200)
-f, --follow Keep printing new lines
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc run <model> [options]
Loads the model on the active engine — the one running now, else engines.default — and makes it answer on the API. It downloads and starts nothing else: a missing model, server or engine is an error that names the command to run first (`atc models pull`, `atc start`, `atc engines install`). `atc unload` stops it; the desktop app calls these Run and Stop.
Arguments:
<model> Model id, as `atc models list` shows it
Options:
--engine <engine> Engine to run it on (llamacpp-upstream, llamacpp, mlx or tensorrt-llm);
remembered as engines.default
--embedding Start it in embedding mode
Examples:
atc run qwen3-8b
atc run qwen3-8b --engine mlx
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc unload [model] [options]
The server keeps running and the model stays downloaded; `atc stop` stops the server.
Arguments:
[model] Model id; --all for every running model
Options:
--all Unload every running model
Examples:
atc unload qwen3-8b
atc unload --all
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc models <command>
The catalog and the model files: search, download, list, remove, describe
Commands:
search Search the curated catalog (and Hugging Face for owner/repo)
pull Download a model into the data folder
list Installed models
rm Delete an installed model
info model.yml, size, capabilities and whether it fits
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc models search <query> [options]
Search the curated catalog (and Hugging Face for owner/repo)
Arguments:
<query> Words, or owner/repo
Options:
--limit <n> Results to show (default: 20)
--fit Only models that fit this machine
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc models pull <model> [options]
Download a model into the data folder
Arguments:
<model> owner/repo, owner/repo:file.gguf or a catalog alias
Options:
--quant <quant> Quantisation to pick (e.g. Q4_K_M)
--mmproj Also download the vision projector
--hf-token <token> Hugging Face token for gated repos (or HF_TOKEN)
Examples:
atc models pull Qwen/Qwen3-8B-GGUF --quant Q4_K_M
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc models list [options]
Installed models
Options:
--loaded Only loaded models
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc models rm <model>
Delete an installed model
Arguments:
<model> Model id
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc models info <model>
model.yml, size, capabilities and whether it fits
Arguments:
<model> Model id
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc engines <command>
No engine ships inside atc: install one before `atc run`. The core knows the hardware and picks the build for it; an engine that runs in a container (TensorRT-LLM) gets that prepared on install, with consent for the one privileged step.
Commands:
list Installed engines and builds, the running one, and what is available
install Install an engine (the build the core recommends for this hardware)
status The running engine and build, driver facts, mismatch warnings
rm Remove an engine build, or the whole engine
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc engines list [options]
Installed engines and builds, the running one, and what is available
Options:
--engine <engine> Only this engine (llamacpp-upstream, llamacpp, mlx or tensorrt-llm)
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc engines install [engine] [options]
Shows what would change on the system before touching it; an engine that needs a container runtime or a driver setting asks first, elevates through sudo, pkexec or UAC, and resumes after a re-login or reboot.
Arguments:
[engine] llamacpp-upstream, llamacpp, mlx or tensorrt-llm; the default engine when omitted
Options:
--build <build> A specific build instead of the recommended one, e.g.
b6000/cuda-cu12.4-x64
--force Reinstall
--dry-run Print what would change and exit
--resume <operation-id> Continue an install after a re-login or reboot
Examples:
atc engines install
atc engines install tensorrt-llm --dry-run
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc engines status
The running engine and build, driver facts, mismatch warnings
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc engines rm <engine> [options]
Remove an engine build, or the whole engine
Arguments:
<engine> llamacpp-upstream, llamacpp, mlx or tensorrt-llm
Options:
--build <build> Only this build
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc hardware <command>
What the core sees of the GPU and CPU
Commands:
show GPUs, VRAM, driver, compute capability, CPU extensions
refresh Probe the hardware again
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc hardware show
GPUs, VRAM, driver, compute capability, CPU extensions
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc hardware refresh [options]
Probe the hardware again
Options:
--cpu-extensions <list> Override, comma-separated (avx,avx2,avx512)
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc api <command>
The OpenAI-compatible API and its key
Commands:
start Start the API on the running server
stop Stop the API
status Where the API listens and whether a key is required
key The API key (stored in the core settings)
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc api start [options]
Start the API on the running server
Options:
--port <port> API port (default: 1337)
--host <host> API bind address (0.0.0.0 to expose) (default: 127.0.0.1)
--api-key <key> Require this key on the API
--api-key-file <path> Read the key from a file (secrets mounts)
--prefix </v1> Path prefix (default: /v1)
--cors Send CORS headers (default: true)
--trusted-host <host> Extra Host value to accept
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc api stop
Stop the API
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc api status
Where the API listens and whether a key is required
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc api key <command>
The API key (stored in the core settings)
Commands:
show Print the key
set Set the key
rotate Generate a new key and restart the API
clear Remove the key (loopback only)
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc api key show [options]
Print the key
Options:
--reveal Print it in full
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc api key set <key>
Set the key
Arguments:
<key> The key
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc api key rotate
Generate a new key and restart the API
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc api key clear
Remove the key (loopback only)
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc admin <command>
The admin listens on 127.0.0.1:1338 by default. From another machine, forward the port: ssh -L 1338:127.0.0.1:1338 user@server
Commands:
open Print the admin URL (with a login token) and open it in a browser
status Where the admin listens
token Print the admin token, or make a new one
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc admin open [options]
Print the admin URL (with a login token) and open it in a browser
Options:
--open Open a browser (--no-open to only print) (default: true)
--host <host> Bind address of a server started by this command (default: 127.0.0.1)
--port <port> Admin port of a server started by this command
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc admin status
Where the admin listens
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc admin token [options]
Print the admin token, or make a new one
Options:
--rotate Replace the token; old login links stop working
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc tui [options]
A live screen for people at a keyboard: the server, the core, the API and running models, the server log, the config, doctor and every command with its help, with keys to start, stop and restart the server and change settings. Bare `atc` opens it on an interactive terminal. It needs a terminal; in scripts use `atc status --json`, in a browser `atc admin`. Every action it offers is also a plain command, and leaving it never stops the server.
Options:
--screen <name> Open on a screen: overview, logs, config, doctor, commands (default:
overview)
Examples:
atc
atc tui --screen logs
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc config <command>
atc settings live in <data>/atc/config.json; ATC_* environment variables and flags override them. Engine parameters (engine.<provider>.<key>) belong to the core.
Commands:
get Print one value
set Set one value in the config file
unset Remove one value from the config file (the default applies again)
list Every key with its value and where it comes from
path Print the config file path
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc config get <key>
Print one value
Arguments:
<key> Dotted key, e.g. api.port
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc config set <key> <value>
Set one value in the config file
Arguments:
<key> Dotted key, e.g. api.port
<value> Value as text (lists comma-separated)
Examples:
atc config set api.port 1337
atc config set models.autoLoad qwen3-8b,gemma-4b
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc config unset <key>
Remove one value from the config file (the default applies again)
Arguments:
<key> Dotted key
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc config list
Every key with its value and where it comes from
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc config path
Print the config file path
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc doctor
Check the installation: folders, config, ports, PATH, GPU driver
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc service <command>
Run the server as an OS service (systemd, launchd, Windows task)
Commands:
install Install and enable the service
uninstall Disable and remove the service
status Whether the service is installed and running
start Start the service
stop Stop the service
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc service install [options]
Install and enable the service
Options:
--system System-wide (needs root)
--name <name> Service name (default: atc)
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc service uninstall
Disable and remove the service
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc service status
Whether the service is installed and running
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc service start
Start the service
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc service stop
Stop the service
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Status: not implemented yet in this build (exit code 3).
Usage: atc update [options]
Update atc to the latest release
Options:
--check Only report whether a newer release exists
--version <x.y.z> Install this version instead of the latest
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc version
Print the atc, core and admin versions
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc completion <shell>
Print a shell completion script (bash, zsh, fish, powershell)
Arguments:
<shell> bash | zsh | fish | powershell
Examples:
atc completion bash > ~/.local/share/bash-completion/completions/atc
atc completion zsh > "${fpath[1]}/_atc"
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version
Usage: atc host-step exec <request>
Run one privileged host step from its request file and write the result beside it
Arguments:
<request> Path to <step_id>.request.json
Global options:
--json Print the result as one JSON document (errors go to stderr as JSON)
-v, --verbose Debug-level logging on stderr
-q, --quiet Only errors on stderr; no progress
-y, --yes Answer yes to safe confirmations; required for elevation and deletion
without a terminal
--data-folder <path> Data folder to work with (default: <system data>/atomic-chat-cli/data)
--no-color Disable ANSI colours (NO_COLOR is honoured too)
-h, --help Show help
--version Print the version