Gems & shards
Multitasking across projects gets messy fast. crystl keeps everything organized with gems, shards, and the Crystal Rail.
A gem is a project workspace in crystl: a directory on your machine with all its terminal sessions grouped together. The Crystal Rail is a glass bar on any screen edge that shows all your gems at a glance. Switch projects with a single click, even with dozens open.
Within each gem, shards are individual terminal sessions. Each shard runs its own shell and can have its own Claude Code instance. Create isolated shards backed by git worktrees for parallel work without conflicts. Claude sessions autosave and restore when you restart crystl, so you pick up right where you left off.
Why it matters
Project-scoped workspaces
Each gem groups all sessions for one project. No more guessing which terminal belongs where.
Tabbed sessions
Shards are tabs inside a gem. Run multiple agents, each on its own task.
Crystal Rail navigation
A glass bar on any screen edge shows all your gems. One click to switch, drag to reorder.
Agent config editor
Set approval mode, pick CLAUDE.md templates, and configure agent files per project, all from Gem Settings.
Session autosave & restore
Claude Code sessions are saved automatically and restored when you restart crystl. No lost context, no re-explaining what you were working on. And if you close a shard by mistake, resurrect it (Cmd+Shift+T) — that works for Claude Code, Codex, and Antigravity CLI conversations alike.
Ready to try it?
Create a free account and download crystl for macOS.
get started getting started guide →Frequently asked questions
- How many projects can I have open at once?
- As many as you like, on every plan including the free one. You're limited only by what your machine can comfortably run.
- Can I rearrange gems in the Crystal Rail?
- Yes. Drag gems to reorder them, and the Rail remembers your layout between sessions.
- What happens to my shards when I close a gem?
- Claude sessions autosave continuously. When you restart crystl, every session is restored exactly where you left off: context, conversation, and all. Closing a gem also saves the session history so you can browse past sessions any time.
- Can two gems point to the same directory?
- Yes. This can be useful for separate workspaces with different shard configurations for the same project.
- Does crystl only work with Claude Code?
- crystl is built around Claude Code, but it also has early support for OpenAI Codex. Features like approval panels rely on hooks that Claude Code provides.
Crystl's Book of Spells
Master crystl with a grimoire of powerful prompts. Summon heroes, assemble a party, revive shards, and complete epic quests.
open the book →More features
Action Panels
See what every Claude session is doing at a glance.
Parallel Sessions
Run multiple Claude instances on the same repo without conflicts.
Hero Shards
Summon a single hero as a shard — its own agent, model, and persona — without a quest party.
History Navigator
Browse, jump through, and search every session: conversation and tool calls.
Token Tracking
Track token burn per shard, estimate turns left, and reclaim context window by disabling heavy plugins and skills.
Workbench
A slide-out task list in every project, backed by a WORKBENCH.md the agent reads and writes with you.
Prompt Integration
Facet Inserts give you one-click access to saved prompts, commands, and shortcuts.
Agent Config Editor
Create, edit, and manage CLAUDE.md, rules, skills, and agent config files with a block editor, file chooser, and project optimizer.
Project Optimizer
Scan your project for gaps in agent configuration (missing files, incomplete docs, oversized code, and setup issues) with one-click fixes.
Starter Bundles
New gems launch with CLAUDE.md, rules, skills, and MCP config, all pre-configured from your bundle library.
Skills Library
Browse and import agentic skills that teach agents like Claude Code or Codex new tricks: code review, testing, deployment, and more.
Cavrn
The terminal as structured data: every turn, tool call, result, and table captured as agent-readable metadata. Drawn fast on the GPU with Metal.
Remote Development
Full crystl integration over SSH: approval panels, file relay, and click-to-open on remote machines.
Agent Orchestration
One agent spawns, supervises, and merges the work of many: a control room for a team of coding agents.
crystl Quest
Assemble a party of specialized agents. Each brings unique skills, coordinates in shared chat, and executes in parallel.
Screenshot Bar
Drag recent screenshots into the terminal. Spotlight-powered, always up to date.
Copy Bar
A one-click copy bar under the terminal. Agents stage text, you click Copy. Editable, up to 10 tabs, free.