- Home
- Codex
Opuscule for Codex
Your Codex sessions, bound as a book.
Opuscule reads your Codex CLI sessions on your Mac and typesets them into a printed volume: your prompts, what happened, the images produced. You proofread everything before it's printed.
The Codex CLI files every conversation in ~/.codex/sessions, sorted by date. Months of work sit there, file after file. Opuscule binds them, together with your Claude Code sessions if you use both.
What a session becomes
- Your promptQuoted exactly as you typed it. Your words are never rewritten.
- What happenedA short summary, written by your own
codexfrom text that's already filtered. - The numbersDuration, number of prompts, agent actions, model.
- The imagesThe ones the agent produced, as they were that day.
The book is organized by project. Every volume also includes an activity report, a closing letter and notes pages. Flip through this week's volume, a fictional sample typeset with the real template.
Claude Code and Codex in the same volume
If you switch between them from one day to the next, your volume brings both together, organized by project. Each spread shows the session's model.
Your sessions stay on your Mac
- Archiving, filtering, layout and proofreading happen on your Mac. The Opuscule server never sees the content of the book.
- Keys, passwords, tokens, card numbers and IBANs are always masked before layout. Masked text is removed from the PDF, not covered.
- Summaries go through your own
codex, with your account, from text that's already filtered. Without it, the book uses excerpts from your sessions. - Only the approved PDF goes to the printer, through a single-use link, and it's deleted once retrieved.
Questions
Where does Codex store my sessions?
In ~/.codex/sessions, one JSONL file per session, filed by date. Sessions archived with codex archive live in ~/.codex/archived_sessions.
Does Codex delete my sessions?
The Codex documentation doesn't describe any automatic deletion of ~/.codex/sessions as of today. A new Mac or a cleanup can still make them disappear: Opuscule archives them as you go on your Mac.
What do I need?
A Mac, and some Codex or Claude Code sessions. For summaries, Opuscule uses codex or claude if they're installed; otherwise, the book uses excerpts from your sessions.
How much does it cost?
Composing and proofreading your book is free. You pay when you approve it, shipping included: from about €21 for a 48-page Short volume in color. Prices for the other formats and the subscription will be set at launch.
Going further: where Codex stores your sessions, and how to find them.