Getting Started with the Guild · crystl Docs

What is the Guild?

The Guild is crystl’s paid tier: $18 a month, or $170 a year to save about 21%.

Guild enables advanced tools so you can get more work done with agents on your own machine. It is the orchestration half of crystl. And it comes with more customization options like agent sequences, customizable heroes and agent parties, as well as the tools for orchestration and super-orchestration.

It also lets you use a cellular connection with the iPhone app to orchestrate your agents from anywhere. Unlike when you use Claude Code or Codex’s built-in subagents, crystl’s orchestration features mean you can see and interact with subagents, and even use combinations of Claude Code, Codex, Antigravity CLI and other agents to fill out your roster.

start here

Joined this week? Read these three, in order.

1. Orchestration: how to run multiple agents. Five ways to run a team, and which one fits the job. Read it first, so you don’t start a quest when a fan-out would have done.
2. Fanout. One agent leads, the others work. This is the one you’ll use most.
3. CLI & Scriptability API. Every command your agent can now call, and what each one does to your window.

Ask for “fanout shards”. Claude Code and the other agents already know the words fan out. Say only “fan this out” and you may get their own built-in subagents, which run inside the session where you cannot see them. Say shards and your agent uses crystl’s fanout instead. Every worker then opens in a shard you can watch, type into, and approve. /fanout does the same job as a slash command, because crystl installs it into Claude Code for you.

You need the word less once an agent holds a role. crystl anoint, a summoned Ruler, and Deus all come with the orchestrator briefing: instructions to coordinate other agents rather than write the code itself. An agent that has read it already knows to dispatch into shards, so you only ask once.

agents that run agents

Say four test files are failing. You tell your lead agent to fix them. It opens four shards, gives each one a file and its own git worktree, waits for all four to finish, then merges the branches back. You watched. You didn’t type.

That whole loop is Guild. On the free tier your agent can read every one of those shards but cannot open one.

• Fanout. The lead-and-workers pattern, start to finish. crystl shard create for each task, crystl wait done to collect them.
• Anoint a shard. crystl anoint gives a shard the orchestrator role, so it coordinates the others instead of writing code itself.
• Isolated sessions. Each worker in its own git worktree and branch, then crystl merge once you’ve read the diff. This is what keeps two agents in one repo from fighting over the same file.
• Vigil. When a whole roster goes quiet, it has usually stalled. A watch runs over every fan-out, nudges the lead, and sends you a card when the nudge doesn’t work.
• The gauntlet. crystl gauntlet opens a release-readiness crew: two Seekers, a Monk, and a Scribe. Worth it before a release, overkill for a bugfix.

a party with personas

Same idea, more structure. Named agents with their own system prompts, talking in one shared chat.

A quest is slower and chattier than a fan-out, though, and it costs more tokens. Pick one when the work needs the agents to disagree with each other. For four files that need fixing, use a fan-out.

• crystl quest. The whole system: a party of agents in one conversation.
• Starting a quest and quest heroes. How one begins, and who you can put in it.
• Hero shards. One specialist on its own, no party needed. The cheapest way to try the idea.
• Parties. crystl party create saves a roster you can summon again. Free accounts get the one built-in party; Guild lets you build your own.
• Court. A crown and a hand that stay seated between tasks, for work that runs longer than a single quest.
• Side quest. A private channel between two shards, so two agents can settle something without filling the main chat.

work that runs without you

• Scheduling. Everyone gets 3 schedules free. Guild removes the cap. Three is plenty until the day you want an overnight triage, a morning inbox pass, and a weekly audit all at once.
• Sequences. Multi-stage pipelines, triggered by hand, by a schedule, by a file changing, or by a poll. Writing one and validating it is free, because the definition is a file in your own repo. Running it needs Guild.
• Formations. Save the arrangement of gems and shards you work in, then put it back with one command. Useful once you keep rebuilding the same four-gem layout. Not much use if you live in one project.

away from the keyboard

• Mobile app. Free on your home Wi-Fi. Guild sends it through an encrypted relay, so you can watch, steer, and approve over cellular or any other network. Your Mac still has to be awake with crystl running; the relay connects you to it, it does not replace it.
• Approvals and questions. crystl approve, crystl deny, and crystl askuser answer let one agent clear another one’s block. That is what lets an unattended fan-out finish, instead of parking on a prompt at 2am.

the library

• Plugins & skills. Writing and using your own skills is free. Browsing the Skills Library catalog and importing from it needs Guild.
• The Book of Spells. Prompts that teach your agent to drive crystl.
• Starter files. crystl bundle install writes a project’s starter set for you. crystl bundle list is free, so you can see what is in a bundle first.

small things you’ll use daily

• Facet inserts. One-click insert buttons in your terminal. You can add them yourself in settings on any tier. What Guild adds is your agent offering you one without being asked.
• Settings and storage. crystl settings set, crystl history clear, and crystl history compact from the CLI, instead of clicking through the panel.

what stays free

Every read is free on every tier. Listing gems and shards, reading a shard’s screen, history and history search, crystl pending, crystl events, crystl wait, crystl search, crystl keys scan, and crystl optimize. So is anything that only shows you something you already own: crystl copy, crystl card, crystl markdown show, crystl report, and crystl screenshots.

The workbench needs spelling out, because the command table lists Guild beside most of its verbs. WORKBENCH.md is a plain markdown file in your repo. An agent on any tier adds tasks, ticks them off, and comments on them by writing that file, and you see each change in the panel straight away. The crystl workbench write verbs are Guild, and what they add is race safety. check reports the state the server recorded, and exits non-zero when another agent got there first. That only matters in a fan-out, which needs Guild for the shards anyway.

Gems, shards, and facet inserts are unlimited on every tier. CLI command tiers is the full 149-command list, built from the same catalog the app enforces, so it cannot drift from what your copy allows.

the licence itself

• One licence covers up to 3 Macs.
• Each renewal emails you a new key. Paste it into Settings > License on each of your Macs. People miss this one a lot. Licensing has the rest, including what happens when you switch between yearly and monthly.
• A shard carries its tier in CRYSTL_TIER, so your agent can plan around it instead of calling a command to find out.
• If a licence lapses, nothing is deleted. Your gems, shards, settings, and history all keep working, and the Guild commands come back the moment you paste a new key.

Not a member yet? Join the Guild.