Qorven ships as a single binary (qorven) at /usr/local/bin/qorven. Every subcommand is documented here; every page is regenerated from qorven <cmd> --help output so it never drifts from the code.

​
Anatomy of a command

qorven [global flags] <command> [subcommand] [flags] [args]
Most commands follow the list / get / create / update / delete pattern: 
qorven agents list                    # all agents for this tenant
qorven agents get b2a19...            # one agent
qorven agents create --name Prime …   # create
qorven agents update b2a19 --model …  # update
qorven agents delete b2a19            # delete

​
Common patterns

Use --output json for scripting

qorven agents list --output json | jq '.[].name'

Point at a different gateway

qorven --server https://qorven.acme.com \
       --token $QORVEN_TOKEN \
       agents list

Skip confirmation prompts

qorven sessions delete <id> --yes

Enable verbose logging

qorven --verbose doctor

​
Categories

Setup & lifecycle

init, setup, start, doctor, status, version, update, backup, migrate, restore.

Day-to-day

chat, agents, sessions, rooms, teams, cron, tasks, memory, tools, providers, channels, workflows.

Ops

gateway, tls, logs, debug, config, mcp, vault, admin.

Security

auth, scan, read, research.

​
Complete list

CommandPurpose
adminAdministrative actions (dangerous; requires root token)
agentAgent-developer tooling (DX scaffolds, local only)
agentsManage Qors — list, create, update, delete
authTokens, sessions, log in/out
backupExport config + agents + sessions + memories + skills
channelsMessaging channel setup (Telegram, WhatsApp, Slack, …)
chatSend a message to a Qor from the CLI
collapse-sessionsMerge extra sessions into the canonical chat (Phase 4 migration)
configShow / edit config.toml
cronScheduled jobs — list, enable, disable, trigger
debugQuick diagnostics dump (config + DB + gateway + providers + channels)
doctorHealth check — runs before you ask for help
gatewayGateway service lifecycle: start/stop/restart
healthQuick /health endpoint check
initInitial setup wizard (first-run)
logsTail / search logs
mcpManage MCP servers you’ve connected
memoryInspect / edit / search agent memories
migrateApply database migrations
modelsSearch the model registry (1700+ models with costs)
providersLLM provider setup + key management
readRead a URL (any platform) into a consumable summary
researchSocial-platform research query
restoreRestore from a qorven backup archive
roomsMulti-Qor rooms
scanScan text for prompt injection (Defender)
sessionsList / get / delete sessions
setupInteractive first-run wizard
startStart the gateway server (what systemd runs)
statusGateway status + metadata
tasksBackground task queue
teamsTeam management
tlsTLS: generate, install CA, show fingerprint, regenerate
toolsList + toggle built-in tools
updateSelf-update to the latest release (SHA-256 verified)
usageToken + cost analytics
vaultObsidian-compatible knowledge vault
versionVersion string + build info
workflowsWorkflows — list, run, disable

​
Where next

Global flags

--server, --token, --output, --verbose, --yes.

Environment variables

QORVEN_SERVER, QORVEN_TOKEN, QORVEN_CONFIG, QORVEN_POSTGRES_DSN.