documentation
Everything you need to know about Crystl.
Concepts
Features
Split View
View multiple shards side by side to multitask within a single gem.
API Key Storage
Store API keys securely in macOS Keychain and auto-inject them into shell sessions.
CLI & Scriptability API
Control Crystl from the command line. Open gems, manage shards, approve permissions, and read terminal output programmatically.
MCP Servers
Manage a global catalog of MCP servers and sync them to projects automatically.
Formations
Save and restore named collections of gems for quick context switching when multitasking across projects.
URL Scheme
Open projects and SSH sessions in Crystl from other apps, scripts, Raycast, or web links using crystl:// URLs.
Metal GPU Rendering
GPU-accelerated terminal rendering using Apple's Metal framework.
Crystal Rail
The frosted-glass bar for managing gems, approvals, and navigation.
Remote SSH Sessions
Use Crystl approval panels with Claude Code running on remote machines over SSH.
Notifications
Floating glass panels for approvals, questions, denials, and activity notifications.
Conversation History
Automatic session saving, browsing, and cleanup.
Facet Inserts
Save and reuse prompts, commands, and shortcuts across all your gems.
Context Load Tracking
Monitor per-shard token usage and estimate how many turns remain before Claude runs out of context.
Starter Files
Reusable project templates for CLAUDE.md, AGENTS.md, .mcp.json, and any other file you want to seed new gems with.
Agent Instruction Files
Create, edit, and manage CLAUDE.md, rules, skills, and other agent config files from within Crystl.
Project Optimizer
Analyze your project's AI readiness and get prioritized recommendations for improving agent instructions.
Crystl Quest
Multi-agent collaboration with parties, roles, and coordinated chat.
Starting a Crystl Quest
Summon a party of agents and begin multi-agent collaboration.
Quest Chat Panel
The chat interface for cross-agent messaging, DMs, and coordination.
Quest Coordination
How agents communicate, route messages, and share context.
Quest Heroes
Built-in hero roles with RPG stats, personalities, and model selection.
Quest System Prompts
the full system prompt injected into each agent during a quest
Side Quest
Bridge two existing shards — across gems or across hosts — for an ad-hoc two-agent chat.