Single commands

All commands

These 25 commands stand alone, with no subcommands.

quox login

Authenticate with QuoxCORE

Usage: quox login [options]

Option	What it does
--email <email>	email address
--password <password>	password (prefer --password-stdin: argv is visible in process lists)
--password-stdin	read the password from stdin (one line): no secret in argv or shell history
--mfa-code <code>	TOTP code for MFA
--org <orgId>	organization to log into
--resident	authenticate as a resident agent using the on-disk Ed25519 identity, no password, no human
--resident-profile <path>	path to the resident bootstrap profile (default: ~/.config/quox/resident-profile.json)

quox logout

End current session

Usage: quox logout [options]

quox whoami

Show current user and session info

Usage: quox whoami [options]

quox signup

Create a new user account

Usage: quox signup [options]

Option	What it does
--email <email>	email address
--password <password>	password
--name <name>	display name

quox health

Check health of all QuoxCORE services (alias for service health)

Usage: quox health [options] [name]

quox status

Show platform health and status overview

Usage: quox status [options]

quox doctor

Run platform health diagnostics

Usage: quox doctor [options]

quox update

Update quox to the latest version (npm, git checkout, or this box’s shared CLI); also quox --update

Usage: quox update [options]

Option	What it does
--check	show what an update would do and change nothing
-y, --yes	update without asking (needed in a non-interactive shell)

quox open

Open a quox:// URI in the dashboard or show CLI equivalent

Usage: quox open [options] <uri>

Option	What it does
--cli	show CLI command instead of opening browser

quox motion

Play the Quox motion gallery: the Q intro, portal, particle, the Dragon’s Eye, the status Q, ring, reveals and the living dragon (no server needed)

Usage: quox motion [options] [scenes...]

Option	What it does
--narrow	use the 40-column layout (the compact Q)
--slow	play three times slower
--mono	no colour (also honoured: NO_COLOR)

quox chat

Chat with CommanderQ or any agent, streaming by default

Usage: quox chat [options] [message]

Option	What it does
--agent <name>	route to a specific agent (e.g. sentinel, cipher, nova)
--no-stream	disable streaming output (one-shot request/response)
--conversation <id>	continue a conversation (session id)

quox chat-status

Check chat service status

Usage: quox chat-status [options]

quox claude

Run Claude Code (same arguments as claude) in a tmux session that survives sleep and drops

Usage: quox claude [options] [-- claude-args...]

quox codex

Run Codex (same arguments as codex) in a tmux session that survives sleep and drops

Run quox codex --help for usage.

quox gemini

Run Gemini CLI (same arguments as gemini) in a tmux session that survives sleep and drops

Run quox gemini --help for usage.

quox wrap

Run any program in a governed tmux session: quox wrap <program> [args…]

Usage: quox wrap <program> [args...]

quox capabilities

What this Quox can do for your org: ready, needs setup, not available, planned

Usage: quox capabilities [options] [name]

quox tips

List the “did you know” tips the terminal shows (/tip); --json for the registry as data

Usage: quox tips [options] [query...]

Option	What it does
--json	print the registry as JSON

quox inventory

Org agent inventory (the agent CMDB): agents, models, tool/credential grants, delegation, unused-grant drift

Usage: quox inventory [options]

Option	What it does
--days <n>	observed-usage window for the unused-grant column (default 30)
--unused	ALSO compute the org-wide unused-grant pass (SLOW: minutes at org scale; for one agent use quox reach unused <agentId>)
--drift	diff against the last stored snapshot and store this rollup as the new baseline (witnessed as quox.reach.inventory_drift)

quox sitrep

LUCID situation report: what needs you, every area, what changed, what LUCID cannot see

Usage: quox sitrep [options]

Option	What it does
--agent	compact, id-rich form for agents
--json	the full structured situation
--spoken	sentences only, as read on the phone

quox gripe

File a one-liner complaint as a GitHub issue (via the GRIPE agent)

Usage: quox gripe [options] <complaint...>

Option	What it does
--repo <owner/name>	target repo (GRIPE defaults sensibly when omitted)
--label <label>	issue label, e.g. bug, idea, fleet
--public	confirm filing to a PUBLIC repo (asks y/N; refused if text has internal hostnames/paths)
--yes	skip the confirmation step and let GRIPE file it directly

quox dashboard

Open the web dashboard signed in (one-time link, 10 minutes). Pages: sessions, approvals, agents, lucid, inbox, seo, settings

Usage: quox dashboard [options] [page]

quox onboard

Guided, idempotent, resumable wizard to onboard a customer site as a governed Quox tenant

Usage: quox onboard [options] <host>

Option	What it does
--name <customerName>	the org display name
--repo <owner/name>	the customer GitHub repo for auto-filed security issues
--target <hostOrIp>	the scan target (defaults to <host>)
--environment-tier <tier>	dev | staging | production (default: “dev”)
--schedule-cron <expr>	cron cadence for the recurring scan (default: “0 2 * * 3”)
--tool <name>	capability tool to schedule (default: “vuln_scan”)
--yes	run non-interactively: do every automatable step and print gate instructions without pausing

quox tui

Launch the classic menu TUI (bare quox opens the conversation)

Usage: quox tui [options] [screen]

Option	What it does
--governed	Run the TUI in a Quox governed tmux session (survives sleep and drops)
--name <name>	Session name for --governed (reattaches if it is already running)
--no-tmux	With --governed: skip tmux

quox completion

Generate shell completions (bash, zsh, fish)

Usage: quox completion [options] <shell>