Parallel sessions

Lead a legion of agents on the same repo at once. Each gets its own branch, so they never collide and you never wait your turn.

works withany CLI agentclaude codecodex · untestedantigravity cli · untested

Isolated shards use git worktrees to give each agent its own working copy of your repo on a separate branch. Send two agents at the same files and they never step on each other: each works in its own instance of the world.

Use split view to watch both agents work side by side in one window. When a shard's work is done, merge it back to main with one click.

Need to script this? The crystl CLI exposes the same worktree spawn as crystl shard create --gem <name> --isolated, so orchestrator agents can fan parallel work out into siblings without the GUI in the loop.

Why it matters

Isolated git worktrees

Each isolated shard gets its own branch and working copy. No file conflicts between agents.

Zero-setup workspaces

crystl detects your package manager, installs dependencies, and symlinks .env files automatically.

Split view

Watch two agents work side by side in one window, like split-screen co-op. Compare output in real time.

One-click merge

Rebase onto main, fast-forward merge, and clean up the worktree, all in one click.

Dive deeper in the Isolated Sessions docs

Ready to try it?

Create a free account and download crystl for macOS.

get started getting started guide →

Frequently asked questions

How many isolated shards can I run at once?
As many as you like, on every plan including the free one. Run as many parallel sessions as your machine can handle.
Do isolated shards work with any git repo?
Yes. They use standard git worktrees, so any git repository works.
What happens if two agents edit the same file?
They can't. Each isolated shard works on its own branch in its own worktree.
What if my project needs a custom setup step?
Add a setupCommand to .crystl/project.json. crystl runs it after dependency installation.
What happens to a shard's branch after merging?
crystl cleans up the worktree and branch automatically after a successful merge.
Book of Spells
the crystl guild

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

Gems & Shards

Gems, shards, and the Crystal Rail keep every project one click away.

Action Panels

See what every Claude session is doing at a glance.

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.