docs/
145 pages · Updated 2026-11-07
Pages
- gems-and-shards
- Project Optimizer · crystl Docs
- Quest Coordination · crystl Docs
- Quest Heroes · crystl Docs
- Agent Activity Panel · crystl Docs
- Hooks · crystl Docs
- Getting Started with the Guild · crystl Docs
- Plugins & Skills · crystl Docs
- Use z.ai open models with crystl · crystl Docs
- CLI command tiers · crystl Docs
- Key Scan · crystl Docs
- Quest Levels · crystl Docs
- NORTH-STAR.md: the direction file for your project
- Local Project Heroes · crystl Docs
- Quest Master · crystl Docs
- Quest System Prompts · crystl Docs
- Model Sizes · crystl Docs
- Formations · crystl Docs
- Orchestration: how to run multiple agents · crystl Docs
- Use vLLM open models with crystl · crystl Docs
- Use llama.cpp open models with crystl · crystl Docs
- Terminal GPU Rendering (Cavrn) · crystl Docs
- Gem types: seven kinds of project, and what each one changes
- Use LM Studio open models with crystl · crystl Docs
- Keyboard Shortcuts · crystl Docs
- Quest Chat Panel · crystl Docs
- Use Ollama open models with crystl · crystl Docs
- Hero Shards · crystl Docs
- Fanout: orchestrate parallel agents · crystl Docs
- New gem setup: what the offer does, and why
- Identity: tell every agent who it works for
- Markdown and Mermaid · crystl Docs
- What’s the best terminal for Claude Code? · crystl FAQ
- My terminal says command not found: crystl · crystl FAQ
- crystl quest · crystl Docs
- Where do I choose the integration branch for isolated shards? · crystl FAQ
- What open source software does crystl use? · crystl FAQ
- Where are agent files, skills, plugins, rules, and starter kits configured? · crystl FAQ
- What is crystl? · crystl FAQ
- What is the crystl CLI? · crystl FAQ
- Is crystl open source? · crystl FAQ
- History Navigator · crystl Docs
- How do I know which agent is waiting on my approval? · crystl FAQ
- What is crystl quest? · crystl FAQ
- Open Models · crystl Docs
- How do MCP servers work? · crystl FAQ
- Where did the isolation button go? · crystl FAQ
- Where are my API keys stored? · crystl FAQ
- Court: the crown and the hand · crystl Docs
- Will crystl overwrite an existing AGENTS.md, CLAUDE.md, or MCP configuration? · crystl FAQ
- Why did my new shard open in a different directory than my last one? · crystl FAQ
- What is the workbench? · crystl FAQ
- Where do I configure approval behavior for a specific gem? · crystl FAQ
- Which files can crystl create inside an existing project? · crystl FAQ
- Where do I change settings for one gem only? · crystl FAQ
- Why do my agents keep overwriting each other’s files? · crystl FAQ
- Why can’t this gem create isolated shards? · crystl FAQ
- What’s the difference between a subagent and a separate session? · crystl FAQ
- What are the auto-approval modes? · crystl FAQ
- Why did crystl start asking me about things it used to approve? · crystl FAQ
- Which agents does crystl work with? · crystl FAQ
- When does “Initialize Git repository” start checked? · crystl FAQ
- How do I update crystl? · crystl FAQ
- Will crystl run git init without asking? · crystl FAQ
- Why is “Use shared shards” the default? · crystl FAQ
- Where did my agent session go after I closed the window? · crystl FAQ
- What is the difference between a gem and a Git repository? · crystl FAQ
- Will crystl create commits automatically? · crystl FAQ
- What’s a formation? · crystl FAQ
- What is the difference between “New Gem” and “Open Gem”? · crystl FAQ
- What is the difference between a shared shard and an isolated shard? · crystl FAQ
- What is the difference between global, gem, and shard settings? · crystl FAQ
- What happens when I create a gem inside an existing repository? · crystl FAQ
- What happens to an agent when I close the terminal tab? · crystl FAQ
- What is the CLAUDE.md manager / agent file editor? · crystl FAQ
- What do “Use shared shards” and “Make standalone repo” mean? · crystl FAQ
- Can I use the crystl library without crystl? · crystl FAQ
- What is available under the shard three-dot menu? · crystl FAQ
- How do I stop agents stepping on each other in one repo? · crystl FAQ
- Is crystl free? · crystl FAQ
- How do I run agents on different branches at the same time? · crystl FAQ
- How much is Guild, and how many devices? · crystl FAQ
- What heroes ship with crystl? · crystl FAQ
- What if I open a folder that is already inside a crystl worktree? · crystl FAQ
- How do I merge or rebase an isolated shard? · crystl FAQ
- What happens to my branch when I close an isolated shard? · crystl FAQ
- What is available under the gem three-dot menu? · crystl FAQ
- How many agents can I run at once? · crystl FAQ
- How do I get notified when an agent finishes if I’m away from the machine? · crystl FAQ
- How can I tell which repository and branch a shard is using? · crystl FAQ
- What are isolated shards? · crystl FAQ
- How do the copy bar and facet inserts work? · crystl FAQ
- How do I get my AI agents to talk to each other? · crystl FAQ
- Is there an iPhone app? · crystl FAQ
- How do I keep track of all my agents? · crystl FAQ
- How do I run multiple agents at once? · crystl FAQ
- How do I add another session versus another project? · crystl FAQ
- What are gems and shards? · crystl FAQ
- Sequences · crystl Docs
- How many agents can be in a quest party? · crystl FAQ
- How do I activate my Guild license, and where’s my key? · crystl FAQ
- How do I get notified when an agent needs me or finishes? · crystl FAQ
- How do gems, shards, and tabs fit together? · crystl FAQ
- Does opening an existing folder as a gem modify its files? · crystl FAQ
- Does opening a gem change its Git history? · crystl FAQ
- Use Kimi Code with crystl · crystl Docs
- Do settings changes affect existing shards or only new ones? · crystl FAQ
- Does every gem need its own Git repository? · crystl FAQ
- Context Load Tracking · crystl Docs
- Do my agents come back after I quit crystl? · crystl FAQ
- Can one agent hand work off to another when it finishes? · crystl FAQ
- Can I use crystl instead of tmux? · crystl FAQ
- Can I contribute to crystl? · crystl FAQ
- Crystal Rail · crystl Docs
- Codex says “Hooks need review”. What do I do? · crystl FAQ
- Does crystl work on Linux or Windows? · crystl FAQ
- Can shared shards edit the same working tree at the same time? · crystl FAQ
- Can I use crystl for regular terminal work? · crystl FAQ
- Does crystl work fully with Codex? · crystl FAQ
- Does closing a gem delete its folder, repository, or shards? · crystl FAQ
- Getting Started · crystl Docs
- Can I use crystl on a remote server over SSH? · crystl FAQ
- Does an isolated shard create a branch, a worktree, or both? · crystl FAQ
- Your agent can drive crystl · crystl Docs
- Can multiple gems point to folders inside the same repository? · crystl FAQ
- Facet Inserts · crystl Docs
- API Key Storage · crystl Docs
- Settings · crystl Docs
- Can I see what crystl changes on my Mac? · crystl FAQ
- Can I schedule an agent to run on its own? · crystl FAQ
- Can I start a worktree from a specific branch? · crystl FAQ
- Can I switch between the yearly and monthly plan? · crystl FAQ
- Can crystl run agents on open models? · crystl FAQ
- Agent Instruction Files · crystl Docs
- FAQ · crystl Docs
- CLI & Scriptability API · crystl Docs
- Isolated Sessions · crystl Docs
- Mobile App · crystl Docs
- Licensing · crystl Docs
- Approval Modes · crystl Docs
- Scheduling · crystl Docs
- Use Claude Code with crystl · crystl Docs
- Use Codex with crystl · crystl Docs
- Updating crystl · crystl Docs
- MCP Servers · crystl Docs