- Home
- Claude Code
Opuscule for Claude Code
Your Claude Code sessions, bound as a book.
Opuscule archives your Claude Code sessions on your Mac before they're deleted, and typesets them into a printed volume you proofread before it goes to the printer.
Claude Code keeps every conversation in ~/.claude/projects, then deletes it after 30 days by default. In between lies a whole quarter of work: features shipped, bugs hunted down at 2 a.m., generated images, three-word prompts and three-screen ones. Opuscule makes it a book.
What a session becomes
Each session becomes a two-page spread:
- Your promptQuoted exactly as you typed it. Your words are never rewritten.
- What happenedA short summary, written by your own
claudefrom text that's already filtered. - The numbersDuration, number of prompts, agent actions, model.
- The imagesThe ones the agent produced, as they were that day.
Every volume also includes an activity report (sessions per month, prompt length, actions per prompt, models, records), a closing letter and notes pages. Flip through this week's volume, a fictional sample typeset with the real template.
Before they're deleted
Opuscule archives your sessions as you go on your Mac, with their images. Your archive stays even when Claude Code cleans up. With the plugin, it happens after every turn. Without it, keep yours with one line in ~/.claude/settings.json:
{ "cleanupPeriodDays": 3650 }
The details, plus a hook to archive every session: Claude Code deletes your sessions after 30 days.
The Claude Code plugin
Opuscule also plugs into Claude Code, so you can talk about your book where you work:
- “Where's my Opuscule volume?” Sessions per project, slots left in the book, data the filter will remove.
- “Keep this moment for the book” The exchange that just happened gets its own spread, your prompt and Claude's answer word for word. You can add a note.
- “Open the Opuscule Studio” To review, compose and order.
- The archive, if you agree After each turn, your sessions and generated images are copied on your Mac, to
~/.opuscule/archive. None gets lost when Claude Code deletes the oldest ones.
The plugin only gives Claude counts and project names, never the text of your sessions. Once Opuscule is installed, in Claude Code:
/plugin marketplace add menufactory43/opuscule-plugin
/plugin install opuscule@opuscule-plugin
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.
- You review risky pages one by one and approve the rest in one go. Nothing is printed without your approval.
- Only the approved PDF goes to the printer, through a single-use link, and it's deleted once retrieved.
Questions
Where does Claude Code store my sessions?
In ~/.claude/projects/<project>/<session-id>.jsonl, one file per session. Opuscule reads them on your Mac, without sending them anywhere.
Do my sessions go through Opuscule's servers?
No. Two things leave your Mac: the already-filtered text your own claude summarizes with your account, and the PDF you approved, handed straight to the printer.
What if I don't want a session in there?
Remove it in one click and another takes its place. You can also mask a word, a name everywhere, or trim part of your prompt.
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.
When is it available?
Opuscule is in testing. The waitlist is there to let you know when the Mac app and payments open.