Skip to content

quox investigate

Documented Checked against the CLI's current help and source. Not run end to end. Last checked on quoxcli 0.6.2, 2026-11-14.

All commands

Investigations: a question taken through optional research, plan, critique and revise rounds to a decision, ending in no action or a QuoxPlan stream (objective + NotesQ collection + brain decisions)

CommandWhat it does
quox investigate open [options] <question>Open an investigation: a not-started objective (metadata.kind investigation) plus its state note in a new NotesQ collection
quox investigate list [options]List investigations (objectives whose metadata.kind is investigation) with stage, round and outcome
quox investigate show <id>Show an investigation: question, state, notes by stage, decisions, outcome
quox investigate add [options] <id>Add a stage note (research, evaluate, plan, critique, revise) to the investigation’s collection
quox investigate research <id> <question>Ask the research agent (the quox research ask route) and save the answer as a research note in the investigation
quox investigate critique [options] <id>Apply a QuoxLens lens (the quox lens apply route) to the latest plan or revise note and save its findings as a critique note
quox investigate decide [options] <id> <what>Record a decision (the quox brain decide route) with provenance naming the investigation
quox investigate close [options] <id>Close an investigation: no-action, or stream (linking an existing QuoxPlan stream). Cancels the objective; the outcome is recorded on the state note
quox investigate handoff [options] <id>Hand off to QuoxPlan: create the stream, write the latest plan note as its plan doc, add a phase per item of its Phases section, link the investigation, close it with outcome stream. With --propose: create one QuoxProposals proposal instead, for a person to decide (required when acting as an agent)