Conversation History

Crystl saves the terminal scrollback for every shard so you can review past sessions at any time. Claude sessions are also autosaved and restored when you restart Crystl — you pick up right where you left off without re-explaining context.

How It Works

Session history is saved to .crystl/history/ inside your project directory. Saves happen automatically:

• When a shard closes
• When a project closes
• When a window closes
• When the app quits
• Every 5 minutes via autosave

Column spacing is preserved, so multi-column layouts like Claude Code headers look the same when you reopen them.

Browsing History

Click the history button in the status bar (next to Gem Settings) to see a list of past sessions for the current gem. From there you can:

• Open an entry — opens the saved session in a new shard
• Delete an entry — removes it from the history list and disk

Session Restore

When you restart Crystl, Claude sessions are automatically restored in every shard. The conversation context, approval state, and session position are all preserved — you pick up exactly where you left off. Guild members also get session restore when loading formations.

Session restore is currently available for Claude Code sessions. Codex and Gemini CLI don’t offer session restore yet — when Crystl restarts, those shards open as fresh sessions. Terminal scrollback history is still saved and browsable for all session types.

Autosave

Autosave runs every 5 minutes so long-running sessions are captured as they go — not just when the shard closes. This also covers Claude session state, so even if Crystl exits unexpectedly your sessions can be recovered. You can turn off autosave in Gem Settings if you prefer to rely on the close-time saves only.

Storage

History files are plain text stored in .crystl/history/ relative to your project root. You can safely add .crystl/ to your .gitignore — it’s meant for local state only.