Skip to content
hal0

CLI reference

hal0 ships a single hal0 binary built with Typer (src/hal0/cli/main.py). Every non-serve subcommand talks to the local daemon on 127.0.0.1:8080 — meaning the CLI and the dashboard end up calling the same code paths.

Implementation status is verified against the docs/handoff-2026-05-15-autonomous.md “What landed” section. Real commands hit live endpoints; stub commands return a NOT_IMPLEMENTED (501) envelope today.

System

Section titled “System”
Terminal window
hal0 status                                  # system + slot summary (real)
hal0 probe                                   # re-run hardware detection (real)
hal0 serve [--host] [--port] [--reload]      # daemon mode (real)

hal0 status is what you run first when something looks off. hal0 probe rewrites /etc/hal0/hardware.json — re-run after BIOS UMA changes, GPU swaps, or RAM upgrades.

Slots

Section titled “Slots”
Terminal window
hal0 slot list                               # real
hal0 slot load <name> [--model M]            # real
hal0 slot unload <name>                      # real
hal0 slot restart <name>                     # real
hal0 slot swap <name> --model M              # real
hal0 slot logs <name> [--follow]             # real — SSE tail of journald

hal0 slot swap is the most-used command in normal operation — change a slot’s model in one call, watch it transition through unloading → starting → warming → ready.

hal0 slot logs <name> --follow is the journald tail wrapped over SSE; it shows the same stream the dashboard’s Logs view tails.

Models

Section titled “Models”
Terminal window
hal0 model list                              # real
hal0 model pull <ref>                        # stub — 501 today
hal0 model rm <ref>                          # real
hal0 model assign <ref> --slot S             # real

Configuration

Section titled “Configuration”
Terminal window
hal0 config show                             # real
hal0 config edit                             # real — opens $EDITOR
hal0 config validate                         # real — schema check
hal0 config migrate                          # real — apply schema migrations

hal0 config validate is safe to run at any time and doesn’t write anything. Use it before hal0 config edit to confirm your starting point is clean.

Updates

Section titled “Updates”
Terminal window
hal0 update                                  # real — apply latest stable
hal0 update --channel stable                 # real
hal0 update --channel nightly                # real
hal0 update --check                          # real — print version, don't apply
hal0 update --rollback                       # real — revert to previous version

See Updates & rollback for the atomic symlink-swap mechanics.

Uninstall

Section titled “Uninstall”
Terminal window
hal0 uninstall [--keep-data]                 # stub — not implemented yet

Talking to the daemon

Section titled “Talking to the daemon”

Almost every subcommand is a thin client on the API. You can hit the same endpoints directly:

Terminal window
curl http://localhost:8080/api/slots
curl http://localhost:8080/api/models
curl -X POST http://localhost:8080/api/slots/primary/restart

The CLI is for ergonomics; the API is the truth.