Headless CLI

    A command-line build of the agent for CI, benchmarking, and unattended scripted runs.

    What it is

    A command-line version of the Atlarix agent for power users — run a task without the desktop app, for benchmarking (Terminal-Bench, SWE-bench), CI pipelines, or unattended scripted runs.

    It drives the same agent loop and auto-approves file and command changes, because it runs unattended. Needs Node 20+.

    Dangerous commands stay blocked by default; an operator can grant that consent once, up front, at launch.

    1. Download and unpack

    Grab atlarix-headless-<version>.tar.gz from the headless-bench release on github.com/AmariahAK/atlarix-releases (a linux/amd64 bundle), then:

    • mkdir -p /opt/atlarix
    • tar -xzf atlarix-headless-*.tar.gz -C /opt/atlarix

    2. Run a task

    export OPENROUTER_API_KEY="sk-or-v1-..."

    node /opt/atlarix/dist-headless/atlarix-headless.mjs --workspace /path/to/repo --prompt-file task.md --provider-id openrouter --model deepseek/deepseek-v4-pro --api-key "$OPENROUTER_API_KEY"

    Use --prompt "..." for an inline task instead of a file.

    Bring your own endpoint

    Point at any OpenAI-compatible API with --provider-url — for example --provider-url https://api.deepseek.com --model deepseek-v4-pro --api-key "$KEY" — including a local Ollama server.

    Every flag also has an ATLARIX_HEADLESS_* environment-variable equivalent.

    Modes, timeout, and exit codes

    --mode build is autonomous coding (the default); --mode ask is read-only exploration. --timeout <ms> caps the run, defaulting to 10 minutes.

    Exit codes: 0 = the agent finished the task, 1 = timeout or error, 2 = bad arguments — handy for scripting.

    ← Back to Docs