Skip to content

quox brain

Documented Checked against the CLI's current help and source. Not run end to end. CLI 0.3.1, checked 2026-10-13.

All commands

Query Quox Qortex (vaults, notes, semantic search)

CommandWhat it does
quox brain search [options] <query>Search the brain
quox brain suggestSuggest questions to ask the brain, generated from your own notes
quox brain brief [options]What is new in your brain (counts by source, top new notes, open questions)
quox brain add [options] [text]Save text (or clip a URL) into your brain as a note
quox brain decide [options] <what>Record a decision (what, why, rejected alternatives, provenance). Checks the brain for an existing match first
quox brain distill [options] [file]Write session learnings as notes from JSONL ({key,title,text,tags?} per line, max 50). Re-running skips existing keys; --undo removes a batch
quox brain statusShow brain status (note count + milestone)
quox brain citations [options]Show persisted agent citations (what was cited, and whether it was supported)
quox brain usageShow brain usage (queries per surface, this week and total)
quox brain vaultsList brain vaults
quox brain note <id>Get note details
quox brain read [options] <noteId>Read one note in full (markdown + content hash for a later update)
quox brain update [options] <noteId>Replace a note’s markdown from a file. A stale --base-hash is a conflict (409), nothing is written.
quox brain delete [options] <noteId>Delete a note (recorded as a revision, restorable in NotesQ). Requires --yes.
quox brain related [options] <noteId>Notes related to one note (by similarity)
quox brain neighbours|neighbors <noteId>Notes this note links to and notes that link to it (graph neighbours)
quox brain context [options] <query>Token-budgeted pack of the most relevant cited passages on a topic (what the Cortex brain_context tool returns)
quox brain check <claim>Check whether the knowledge brain supports, contradicts or says nothing about a claim (what the Cortex brain_check tool returns)
quox brain why <queryOrTarget> [noteId]Two modes. why &lt;target&gt;: the commits, dev sessions and decisions behind a commit sha or file path. why "&lt;query&gt;" &lt;noteId&gt;: why a note ranked where it did, or why it is missing (Cortex brain_why tool)
quox brain history [options] <noteId>A note’s revision history, or with --rev the text of that revision
quox brain restore [options] <noteId> <rev>Restore a note to an earlier revision (recorded as a new revision). --expected-hash must be the note’s current content_hash (see quox brain read).
quox brain judge [options] <query> [noteId]Label a query: a note is relevant/irrelevant for it, or the query should abstain
quox brain judgements [options]List your relevance judgements (the eval set)
quox brain subscribe [options] <topic>Tell a slot when new notes about a topic land in your brain
quox brain subscriptionsList your topic subscriptions
quox brain unsubscribe <id>Remove a topic subscription
quox brain sourcesList the Feed sources that fill your brain (state and last sync)
quox brain source [options] <type>Turn a Feed source on or off and set its config (host paths need an org admin and the instance allow-list)
quox brain eval [options]Replay your judged queries against live search and score retrieval (hit@1/3/k, MRR, abstention)
quox brain export [options]Export your visible notes (jsonl to stdout/--out file, or markdown files into --out dir)