Skip to content

quox notes

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

NotesQ: governed markdown notes (list, read, write, history, restore)

CommandWhat it does
quox notes ls [options]List notes
quox notes search [options] <text>Search notes (same as ls --q)
quox notes show [options] <id>Show a note: title, properties, markdown (--raw: full body incl. frontmatter)
quox notes new [options]Create a note. Markdown from --file or --stdin, else ”# <title>”
quox notes edit [options] <id>Replace a note’s markdown (--file or --stdin). Fails with a conflict if the note changed since it was read.
quox notes facets [options]Collections and tags with counts
quox notes history <id>Revision history of a note
quox notes restore [options] <id>Restore a note to an earlier revision (writes a new revision)
quox notes rm [options] <id>Delete a note (author or org admin only). Requires --yes. --purge permanently erases the note and every revision (human only, irreversible).
quox notes related [options] <id>Notes related to this one (lexical until embeddings are backfilled, then hybrid)
quox notes suggest [options] <id>Link suggestions for a note: other notes whose title appears as plain text, then related notes. --link <targetId> turns the first mention into a [[wikilink]]
quox notes health [options]Notebook health: duplicate groups, stale notes others rely on, and broken [[links]]
quox notes import [options] <file>Import notes from an Evernote export (.enex), an Obsidian vault (.zip) or markdown (.md/.zip)
quox notes tag [options] <id>Change a note’s tags, collection, pinned or archived state without touching its text
quox notes append [options] <id> [text]Append text to the end of a note (blank line between). Text from the argument, --stdin or --file.
quox notes duplicate <id>Copy a note in the same scope as “<title> (copy)” (pinned, source and import_ref are not copied)
quox notes attach <id> <file>Upload a file (max 25 MB) to the org file store and append a reference to the note
quox notes attachments <id>List the org files a note references (name, file id, url)
quox notes download [options] <fileId>Download an org file (by file id, see quox notes attachments). Never overwrites without --force.
quox notes export [options]Export notes as a zip of <collection or Unfiled>/<title> <id8>.md with frontmatter intact (archived notes included)
quox notes import-status <jobId>Show an import job: status, counts and errors. Exits non-zero if the job or any note failed.
quox notes templatesList note templates: built-ins (daily, weekly, meeting, decision) and your notes marked as templates (property template: true)
quox notes scheduleScheduled notes: create a note from a template every day or week (runs server-side, your time zone)
quox notes from-email [options] <messageId>Save an InboxQ email as a note (subject as title, sender and date, body quoted). Defaults to your personal notes
quox notes actions [options] <id>Send a note’s unchecked tasks (- [ ] …) to Action-Q, each linking back to the note. Shows them unless --yes; tasks already sent are skipped
quox notes promote [options] <id>Promote a note to a QuoxPlan stream: appends a stream note with the title, link and an excerpt
quox notes batch [options] <source>Create many notes in one governed job (max 200) from a folder of markdown, a .jsonl file, or JSONL on stdin. Dry run unless --yes. Every note is tagged with the batch, so quox notes batch-undo removes the lot
quox notes batch-undo [options] <batchId>Soft-delete every note one batch created (revisions kept, each note restorable). Shows what it would remove unless --yes
quox notes propose-skill [options] <id>Propose a note (an SOP) as a skill. It always lands pending human review, never runs until approved. Shows the derived skill unless --yes
quox notes split [options] <id>Split a note at its headings into child notes (one batch), and turn the original into an index linking to them. Dry run unless --yes
quox notes settingsNotesQ platform settings (alias over quox settings, NOTESQ_ keys only). Changing one needs a human org admin.
quox notes scorecard [options]Run the NotesQ scorecard (scripts/notesq-scorecard.mjs in the dashboard repo), streaming its output