Notes from the terminal
Can I write and find notes from the terminal?
Create a note, search for it by a word, then read it back, add to it and tag it, without opening the dashboard.
What you get: a note written and found again in seconds. Notes you create here are the same notes you see in the dashboard and in chat.
Ask Quox
Section titled “Ask Quox”Ask in plain words:
Add a note titled 'Q4 supplier review' saying 'call the three shortlisted suppliers by Friday'. Then search my notes for supplier.
▤ AOCL │ L1 identity complete · allowed · 0ms
▤ AOCL │ L3 policy gate complete · proceed · 5ms
◐ BRAIN │ save ✔ BRAIN │ save │ ok · 3.6s
⛓ AEE │ envelope opened · ops.tool · brain_save ok
◐ NOTESQ │ search ✔ NOTESQ │ search │ 1 total, 1 count, 1 notes · 1.3s
⛓ AEE │ envelope opened · ops.tool · notesq_search ok
⛓ AEE │ envelope opened · stream_success
I've saved the note "Q4 supplier review" with the text "call the three shortlisted suppliers by Friday". A search of your notes for "supplier" found one note, the one I just saved. You can open it at /notes?note=79f683bc8d4954b1d3f1145b1a0112aba908ec7e .
19.9s · 2 tools · 0 approvals
quox.✔ Machine verified against the CLI on 4 Nov 2026 · test report mw2eiq
Quox handed the job to the notes agent, which saved the note and then searched for it, and the search found the one note.
Do it yourself
Section titled “Do it yourself”1. Write a note
Section titled “1. Write a note”printf '# Q4 supplier review Call the three shortlisted suppliers by Friday.' | quox notes new --stdinCreated note 70c13b6eb2be6afd4489ff73a6cc6bbf0d61a12c (Q4 supplier review).The text comes from --stdin or --file, and the note’s title is its first # heading, so start your text with one. With neither, --title gives you a note that is just that heading. Add --tag <tag> to file it under a tag from the start.
2. Find it again
Section titled “2. Find it again”quox notes search supplierTitle Scope Collection Tags Updated IDQ4 supplier review org 2026-11-04T17:43:11.877Z 70c13b6eb2be6afd4489ff73a6cc6bbf0d61a12c🌌 QORTEX │ notes ls │ 1 of 1quox notes ls lists everything the same way. Copy the id from the last column for the next steps.
3. Read it
Section titled “3. Read it”quox notes show 70c13b6eb2be6afd4489ff73a6cc6bbf0d61a12cid 70c13b6eb2be6afd4489ff73a6cc6bbf0d61a12ctitle Q4 supplier reviewscope orglink /notes?note=70c13b6eb2be6afd4489ff73a6cc6bbf0d61a12c # Q4 supplier review Call the three shortlisted suppliers by Friday.4. Add to it
Section titled “4. Add to it”quox notes append 70c13b6eb2be6afd4489ff73a6cc6bbf0d61a12c "Ask each for a revised quote."Appended to note 70c13b6eb2be6afd4489ff73a6cc6bbf0d61a12c (rev 2).The new text goes at the end, after a blank line. Nothing already in the note is touched.
5. Tag and pin it
Section titled “5. Tag and pin it”quox notes tag 70c13b6eb2be6afd4489ff73a6cc6bbf0d61a12c --add suppliers --pintags: supplierscollection: (none)pinned: yes | archived: no🌌 QORTEX │ notes tag │ rev 3Tags, collection, pinned and archived change without touching the note’s text.
6. Turn a how-to note into a skill
Section titled “6. Turn a how-to note into a skill”A note that says how to do something, step by step, can be proposed as a skill. It is reviewed before any agent uses it, and without --yes the command only shows what it would propose. Here the note came from a markdown file, reset.md, of four numbered steps:
quox notes new --file reset.md --tag howtoCreated note 020e9bbb603030f9a7c76e2808a169528367e008 (Reset a tripped boiler).quox notes propose-skill 020e9bbb603030f9a7c76e2808a169528367e008name: reset-a-tripped-boilercategory: proceduredescription: Use this when a customer reports that the boiler has stopped and shows a fault light.# Reset a tripped boiler Use this when a customer reports that the boiler has stopped and shows a fault light. 1. Ask the customer to read the pressure gauge. It should be between 1 and 1.5 bar.2. If the pressure is low, talk them through topping it up with the filling loop.3. Ask them to press and hold the reset button for five seconds, then wait two minutes.4. If the boiler trips again, book an engineer visit for the same day and note the fault code.Re-run with --yes to propose it. It lands as an experimental skill, outside the stable library; an automated safety check reviews it and anything flagged goes to the human review queue (quox skills review).The skill’s name comes from the note’s title, and --name or --category change it. A very short note is refused, so give it the real steps. We stopped at the preview here, then removed the note with quox notes rm <id> --yes.
What just happened
Section titled “What just happened”Each command changed or read one note in your organisation’s notes. The edits are saved as revisions, so quox notes history <id> shows each version and quox notes restore <id> goes back to an earlier one.
Check it yourself
Section titled “Check it yourself”Run quox notes search supplier again after each step. The note should appear after step 1, and quox notes show should end with your appended line after step 4.
quox notes restore <id> returns a note to an earlier revision. quox notes rm <id> --yes deletes a note you wrote.