Skip to content
Free Store
Get started
quoxcli

File an email, with your say-so

Machine verified A machine ran this on our install and checked the result against the CLI. A test report is linked. CLI 0.4.0, checked 2026-11-05.

Can you file this one for me?

Name the email and the folder. Quox finds it and raises a proposal you approve later.

What you get: tidy folders without letting an agent rearrange your mailbox on its own.

Ask Quox

Section titled “Ask Quox”

Say which email and where it goes:

quox · talking to Quox

Do not move it yourself. Raise a proposal I can approve later to file the email "Accepted: Weekly team sync" into a folder called Receipts ac83b7.

▤ AOCL │ L1 identity complete · allowed · 1ms

▤ AOCL │ L3 policy gate complete · proceed · 7ms

◐ INBOX │ accounts ✔ INBOX │ accounts │ 1 accounts · 1.3s

⛓ AEE │ envelope opened · ops.tool · inbox_accounts ok

◐ INBOX │ search ✔ INBOX │ search │ 1 total, 1 messages · 10.3s

◐ INBOX │ folders ✔ INBOX │ folders │ 0 folders · 27.2s

⛓ AEE │ envelope opened · ops.tool · inbox_search ok

⛓ AEE │ envelope opened · ops.tool · inbox_folders ok

◐ INBOX │ propose move ✔ INBOX │ propose move │ PROPOSAL CREATED (id inbprop_mw331bhm_gqik5peq), NOT EXECUTED (proposed: true, applied: false). Nothing has changed yet… · 15.5s

⛓ AEE │ envelope opened · ops.tool · inbox_propose_move ok

⛓ AEE │ envelope opened · stream_success

I've raised a proposal to file the email, and nothing has moved yet.

• Proposal:  inbprop_mw331bhm_gqik5peq , status "proposed", "NOT EXECUTED".
• What it covers: the one message matching "Accepted: Weekly team sync". It's from
  Calendar, and says Sam Whitlock accepted your Monday 09:30 invitation. The destination
  is a folder called "Receipts ac83b7".
• Folder creation: the account had no custom folders, so I set the proposal to create
  "Receipts ac83b7" if it's missing. Approving it covers both the folder creation and
  the move.

You can approve or deny it in the InboxQ Approvals card whenever you like.

65.2s · 4 tools · 0 approvals

A real turn on our own install (CLI 0.4.0, 5 Nov 2026), replayed at speed. Names changed. Type the same words into quox.
✔ Machine verified against the CLI on 5 Nov 2026 · test report mw32zy

Quox found the one matching message, saw the folder did not exist yet, and raised a single proposal that covers both creating the folder and filing the email. The proposal says “NOT EXECUTED”: nothing has moved.

Do it yourself

Section titled “Do it yourself”

1. See your proposals

Section titled “1. See your proposals”
proposals waiting, and decided 
quox mail proposalsID                           Kind             Account                     Status    Createdinbprop_mw331bhm_gqik5peq    file             inbacc_mw2shxd7_nd4xvapl    denied    2026-11-05 05:05:43
From a real run on our demo organisation, after the proposal above was denied. Trimmed.

2. Approve or deny one

Section titled “2. Approve or deny one”
Terminal window
quox mail resolve <proposal-id> --decision approve
quox mail resolve <proposal-id> --decision deny

3. Raise one yourself

Section titled “3. Raise one yourself”

quox mail propose --account <account-id> --kind file --payload '<json>' creates the same kind of proposal from the shell. --kind also takes block and draft.

What just happened

Section titled “What just happened”

The proposal was stored on your Quox, against your mailbox, and the mail server was not touched. Approve it and Quox creates the folder and moves the email over IMAP. Deny it and nothing changes.

Check it yourself

Section titled “Check it yourself”

quox mail moves lists recent moves Quox made, most recent first, so you can see what an approved proposal actually did.

Undo

Section titled “Undo”

Deny the proposal and nothing happens. If you approved it, quox mail undo <move-id> moves the email back to its source folder.

Next

Section titled “Next”