Skip to content

Close a session and bring it back by name

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

Can I close it and pick it up later?

End a session when you are done. Bring it back by name, with its history, when you need it again.

What you get: a session you can close without losing it. quox sessions attach <name> brings the same conversation back, in the folder it started in, and the bar at the bottom always shows the way back out.

Everything below is from one real run of the released [email protected] on our dev box, with a throwaway session called orchid-review.

In Quoxon (type quox), ask about a session by its name. Quoxon answers these on your machine and asks before it does anything:

quoxon
› what is orchid-review doing?⚠ This terminal asks: Run /sessions peek orchid-review?do     /sessions peek orchid-reviewwhy    orchid-review is a session here: this shows its screen, read only, and changes nothing▶ Run /sessions peek orchid-review? y yes · n no · c chat✔ Run /sessions peek orchid-review? yes (00:24)Ⓠ QUOX │ peek orchid-review │ idle · up 3m · dev-box❯ Draft three short review notes for the orchid greenhouse sensor dashboard. Keep it to a list.✻ Worked for 26s · done Friday 3:34 PM› take me into orchid-review⚠ This terminal asks: Run /sessions attach orchid-review?do     /sessions attach orchid-reviewwhy    orchid-review is a session here: going in hands this terminal over to it▶ Run /sessions attach orchid-review? y yes · n no · c chat✔ Run /sessions attach orchid-review? yes (00:24)⚠ This terminal asks: Go into orchid-review?do     go into orchid-reviewwhy    Ctrl-b d or /session exit to come back to Quoxon▶ Go into orchid-review? y go in · n stay✔ Go into orchid-review? yes (00:25)Ⓠ QUOX │ attach orchid-review │ Ctrl-b d or /session exit to come back to QuoxonBack in Quoxon from orchid-review.
From a real run, quox 0.6.2. Trimmed: Quoxon's banner and status lines are cut, the peeked screen is cut to its first and last lines, and the host name is replaced.

“What is orchid-review doing?” shows its screen and changes nothing. “Take me into orchid-review” asks twice (run it, then go in) before it hands your terminal over. Pressing Ctrl-b d inside brought us straight back to Quoxon.

quox sessions lists what is working, waiting and idle, then an Off group: closed conversations you can bring back. Rows you can act on are numbered, so quox sessions attach 4 works too.

sessions
quox sessionsOff (24) · quox sessions attach <name> resumes it4  ○ off      orchid-review    1d ago+16 older · quox sessions all
From a real run, quox 0.6.2. Trimmed to the Off group header and orchid-review.

quox sessions attach <name> on a closed session asks first, then resumes the same conversation:

attach
quox sessions attach orchid-revieworchid-review is off. Resume its conversation (last active 1d ago)? [y/N] y❯ Draft three short review notes for the orchid greenhouse sensor dashboard. Keep it to a list.- Alert thresholds need units and context.- Stale sensor data should be obvious.- Trends matter more than snapshots.✻ Worked for 26s · done Friday 3:34 PM──────────────────────────────────────────────────────── orchid-review ─❯[quox-orch0:claude*                 Ctrl-b d or /session exit · back to Quoxon
From a real run, quox 0.6.2. Trimmed: the conversation's middle lines are cut, each note is cut to its first sentence, a usage line is cut, and the two bar lines are narrowed.

The history is back: the request and the answer from before it was closed. The bar at the bottom shows the way back out.

Press Ctrl-b then d. The session keeps running, and you are back at your prompt:

detach
Ⓠ QUOX │ attach orchid-review │ Ctrl-b d or /session exit to come back[detached (from session quox-orchid-review)]
From a real run, quox 0.6.2.

quox sessions now lists it as idle on this host, with the command to go back in:

sessions
quox sessions20  ○ idle     orchid-review     tmux·claude   this host    1m    quox sessions attach orchid-review
From a real run, quox 0.6.2, with a login in the organisation this machine reports to (see Limits). Trimmed to the orchid-review line; columns narrowed.

quox sessions peek <name> shows the end of its screen. It is read only and types nothing:

peek
quox sessions peek orchid-reviewⓆ QUOX │ peek orchid-review │ idle · up 53s · dev-box❯ Draft three short review notes for the orchid greenhouse sensor dashboard. Keep it to a list.✻ Worked for 26s · done Friday 3:34 PM
From a real run, quox 0.6.2. Trimmed: the middle of the screen is cut, and the host name is replaced.

Peek works on a running session. On a closed one it says there is nothing called that running; bring it back first.

quox sessions kill <name> ends it after a y/N. The conversation stays, and it goes back under Off:

kill
quox sessions kill orchid-reviewStop orchid-review? Its conversation and address are kept. [y/N] yⓆ QUOX │ stop orchid-review │ stopped ✔Conversation kept: quox claude --resume orchid-reviewStart it again: quox sessions attach orchid-reviewquox sessionsOff (24) · quox sessions attach <name> resumes it1  ○ off      orchid-review    12s ago
From a real run, quox 0.6.2. The second list is trimmed to the Off group header and orchid-review.

A closed session is a saved Claude conversation on this machine. quox sessions attach starts it again inside a tmux session named after it, resuming the same conversation in the folder it started in. kill ends that tmux session and nothing else, so the conversation can come back as often as you like.

Each of these acts left a witnessed record, stamped by the server with the person who did it: the resume (00MWH39YDT04HCRLB6EYY7R5AX), the attach from Quoxon (00MWH3F4ZYH76ALYZKFGPW0BUF) and the stop (00MWH3G816S9L8H64TEQX9NMU7). Find your own with quox aee query --intent quox.session.stop.

quox sessions shows it under Off. quox sessions all lists every closed conversation, not just the latest.

  • This machine’s Claude sessions only. Server chat cannot see a machine’s sessions, by design: ask Quoxon in your terminal, not the web chat.
  • Codex sessions are not covered yet.
  • This machine’s sessions are listed only for a login in the organisation this machine reports to. With a login in another organisation, quox sessions shows that organisation’s conversations and the Off group, but not the live sessions here.
  • Proven on one host in one organisation.

Nothing to undo: kill keeps the conversation. Bring it back with quox sessions attach <name>.