First run

The first time you run bare quox in a terminal, it shows a short notice once:

• who we are: the main front door to Quox, your self-hosted control plane for AI agents
• links to the docs, the Terms and the Privacy policy
• the licence name: Quox Community Source Licence 1.0 (source-available)
• where your prompts go: to your own QuoxCORE server, and to the AI provider you connect to it
• that risky actions ask you first, and actions Quox takes leave receipts
• that this CLI sends no telemetry to Quox
• that by using Quox CLI you agree to the Terms

Press Enter to continue. It is shown once, and again only if the notice itself changes. Its final wording is still being settled, so details here may change.

See it again

/about

/about shows the same information at any time.

When the notice is skipped

It is not shown when output is not a terminal, with --print, or when QUOX_NO_WELCOME=1 is set. Quox records that you have seen it in ~/.config/quox/welcome.json.

Name your session

quox -n release-checks

The name shows in the top rule and in /sessions. You can also name a session later with /rename. See Sessions and agents.

Try it with no server

quox --demo

This plays a simulated journey with demo data. No server is contacted and nothing real runs.

Next

Quickstart