CLI command tiers
Updated October 1, 2026
Every crystl command is either free on every tier or needs a Guild membership. This page is the full list, generated from the same catalog the app itself enforces, so it cannot drift from what your copy of crystl actually allows.
The rule
Two sentences cover almost all of it:
- Every read is free. Listing gems and shards, reading a shard’s screen, reading history, checking what is pending, waiting on an event, searching, scanning for keys, scoring a project: free on every tier, always.
- Changing something needs Guild. Opening a gem, creating or closing a shard, typing into another shard, approving a tool call, merging a branch, starting a quest.
Four deliberate exceptions sit on top of that:
- Showing you something is free, whatever it costs the app. A command whose whole job is to surface something you already own does not change anything, so it is never gated:
crystl copy,crystl card,crystl markdown show,crystl history show,crystl sequence open, and the workbench panel controls (workbench open,close,toggle). - Telling us about a bug is free.
crystl report bug,idea, andpraise. - Describing your own machine is free.
crystl agent profile setandcrystl endpoint set/removerecord which agents and model providers you already pay for. That is local configuration, not control, and gating it would leave a free account’s agents pointed at the wrong model with no way to say otherwise. - Scheduling is capped, not gated.
crystl schedule addandcrystl schedule cancelare free up to 3 schedules, counted across your whole machine. Disabling one does not free a slot, and a rotating schedule counts as one however many prompts it holds. Past the cap,schedule addanswers403 limit_reachedrather thanguild_required, and Guild lifts the cap.
A Guild command on a free account answers 403 guild_required. Nothing breaks and nothing is lost: the table below says what to do instead for each one, and that is the same wording crystl writes into your agent’s instructions, so an agent on a free account reaches for the alternative rather than the command that will refuse it.
What an agent is told
crystl writes the tier rules into your agent’s instructions in two places, because a file you commit cannot know who will open it:
- Your project’s
CLAUDE.md/AGENTS.mdgets the tier-neutral version. It marks each Guild command and pairs it with the free alternative, which stays true for anyone on the team whatever tier they are on. - Your machine’s global instruction file (
~/.claude/CLAUDE.md,~/.codex/AGENTS.md) gets the version that knows your licence. On a free account it describes the capability in plain English, says it needs Guild, and gives the free alternative as the instruction, without naming the command that would refuse. It is rewritten when crystl launches and whenever your licence changes, andcrystl uninstalltakes it out again.
A shard also carries its tier in CRYSTL_TIER, so an agent can plan around it instead of calling a command to find out.
The full list
149 commands: 78 free on every tier, 71 need Guild.
| Command | Tier | On a free account |
|---|---|---|
crystl status |
free | works |
crystl gems |
free | works |
crystl shards |
free | works |
crystl screen |
free | works |
crystl fs |
free | works |
crystl pending |
free | works |
crystl events |
free | works |
crystl commands |
free | works |
crystl files |
free | works |
crystl gitstate |
free | works |
crystl search |
free | works |
crystl optimize |
free | works |
crystl wait pending |
free | works |
crystl wait askuser |
free | works |
crystl wait notification |
free | works |
crystl wait awaiting |
free | works |
crystl wait idle |
free | works |
crystl wait blocked |
free | works |
crystl wait done |
free | works |
crystl docs |
free | works |
crystl doctor |
free | works |
crystl token |
free | works |
crystl render |
free | works |
crystl screenshots |
free | works |
crystl uninstall |
free | works |
crystl copy |
free | works |
crystl card |
free | works |
crystl report bug |
free | works |
crystl report idea |
free | works |
crystl report praise |
free | works |
crystl report other |
free | works |
crystl dispatch verify |
free | works |
crystl scrollback clear |
free | works |
crystl markdown list |
free | works |
crystl markdown show |
free | works |
crystl edit |
free | works |
crystl agent list |
free | works |
crystl agent profile show |
free | works |
crystl agent profile set |
free | works |
crystl agent profile suggest |
free | works |
crystl endpoint list |
free | works |
crystl endpoint set |
free | works |
crystl endpoint remove |
free | works |
crystl schedule list |
free | works |
crystl schedule add |
free | works |
crystl schedule cancel |
free | works |
crystl send |
Guild | ask the user to type it into that shard |
crystl watch |
Guild | re-read crystl screen after your next step instead |
crystl abort |
Guild | ask the user to press Esc in that shard |
crystl notify |
Guild | crystl card the user with the status instead |
crystl vigil done |
Guild | crystl card the user the summary and let the watch lapse |
crystl approve |
Guild | the user clicks Allow on the approval card |
crystl deny |
Guild | the user clicks Deny on the approval card |
crystl askuser list |
free | works |
crystl askuser answer |
Guild | the user answers on the question card |
crystl facet add |
Guild | crystl copy the text instead |
crystl facet slot |
Guild | crystl copy the text instead |
crystl facet remove |
Guild | ask the user to remove it from the facet row |
crystl facet list |
free | works |
crystl formation list |
free | works |
crystl formation save |
Guild | ask the user to arrange the window themselves |
crystl formation apply |
Guild | tell the user which gems and shards to open |
crystl ssh bridge-address |
Guild | ask the user to set it in settings → ssh |
crystl open |
Guild | ask the user to open the folder as a gem |
crystl close |
Guild | ask the user to close the gem tab |
crystl gem select |
Guild | tell the user which gem to click |
crystl gem type get |
free | works |
crystl gem type set |
Guild | write the type line into NORTH-STAR.md yourself |
crystl shard create |
Guild | ask the user to open a new shard themselves |
crystl shard close |
Guild | ask the user to close the shard |
crystl shard rename |
Guild | ask the user to rename the shard |
crystl shard select |
Guild | name the shard and ask the user to click its pill |
crystl resurrect list |
free | works |
crystl resurrect restore |
Guild | ask the user to reopen the shard |
crystl merge |
Guild | ask the user to merge the branch |
crystl anoint |
Guild | tell the shard to orchestrate in the prompt you send it |
crystl gauntlet |
Guild | ask the user to open the crew’s shards themselves |
crystl workbench list |
free | works |
crystl workbench open |
free | works |
crystl workbench close |
free | works |
crystl workbench toggle |
free | works |
crystl workbench add |
Guild | edit WORKBENCH.md in the project directly |
crystl workbench cycle |
Guild | edit WORKBENCH.md in the project directly |
crystl workbench start |
Guild | edit WORKBENCH.md in the project directly |
crystl workbench check |
Guild | edit WORKBENCH.md in the project directly |
crystl workbench uncheck |
Guild | edit WORKBENCH.md in the project directly |
crystl workbench delete |
Guild | edit WORKBENCH.md in the project directly |
crystl workbench section |
Guild | edit WORKBENCH.md in the project directly |
crystl workbench comment |
Guild | edit WORKBENCH.md in the project directly |
crystl workbench uncomment |
Guild | edit WORKBENCH.md in the project directly |
crystl workbench archive |
Guild | edit WORKBENCH.md in the project directly |
crystl workbench heal-ids |
Guild | edit WORKBENCH.md in the project directly |
crystl bundle list |
free | works |
crystl bundle install |
Guild | write the starter files yourself after crystl bundle list |
crystl northstar init |
Guild | write NORTH-STAR.md yourself |
crystl northstar reject |
Guild | add the dated rejection line to NORTH-STAR.md yourself |
crystl keys scan |
free | works |
crystl keys patterns list |
free | works |
crystl keys patterns add |
Guild | crystl copy the prefix and ask the user to add it in settings → keys |
crystl settings show |
free | works |
crystl settings get |
free | works |
crystl settings set |
Guild | ask the user to change it in settings |
crystl history replay |
free | works |
crystl history search |
free | works |
crystl history metrics |
free | works |
crystl history show |
free | works |
crystl history clear |
Guild | ask the user to clear history in settings → storage |
crystl history compact |
Guild | ask the user to press compact in settings → storage |
crystl quest start |
Guild | a quest is a party of shards in a shared chat; no free command starts a shard, so nothing on the free tier stands in for it |
crystl quest master |
Guild | a quest is a party of shards in a shared chat; no free command starts a shard, so nothing on the free tier stands in for it |
crystl quest propose |
Guild | tell the user which heroes to pick in the begin-quest panel |
crystl quest levels |
free | works |
crystl quest clear |
Guild | a quest is a party of shards in a shared chat; no free command starts a shard, so nothing on the free tier stands in for it |
crystl quest end |
Guild | a quest is a party of shards in a shared chat; no free command starts a shard, so nothing on the free tier stands in for it |
crystl quest templates list |
free | works |
crystl quest templates save |
Guild | a quest is a party of shards in a shared chat; no free command starts a shard, so nothing on the free tier stands in for it |
crystl quest templates delete |
Guild | a quest is a party of shards in a shared chat; no free command starts a shard, so nothing on the free tier stands in for it |
crystl sidequest start |
Guild | a side quest is a private channel between two shards; there is no free channel to open instead |
crystl sidequest end |
Guild | only the shard that opened a side quest can close it, and a free account cannot open one |
crystl sidequest status |
free | works |
crystl hero list |
free | works |
crystl hero summon |
Guild | it starts shards, and no free command starts a shard |
crystl party list |
free | works |
crystl party create |
Guild | keep the roster in your own notes and name the heroes when asked |
crystl party delete |
Guild | ask the user to delete it in the party list |
crystl court status |
free | works |
crystl court convene |
Guild | it starts shards, and no free command starts a shard |
crystl court add |
Guild | it starts shards, and no free command starts a shard |
crystl court dismiss |
Guild | ask the user to close that shard |
crystl court end |
Guild | ask the user to close the court’s shards |
crystl sequence new |
free | works |
crystl sequence list |
free | works |
crystl sequence runs |
free | works |
crystl sequence status |
free | works |
crystl sequence schema |
free | works |
crystl sequence validate |
free | works |
crystl sequence open |
free | works |
crystl sequence run |
Guild | a sequence run drives shards and stages on a trigger; the free tier has no equivalent, so the draft is as far as it goes |
crystl sequence publish |
Guild | a sequence run drives shards and stages on a trigger; the free tier has no equivalent, so the draft is as far as it goes |
crystl sequence draft |
Guild | a sequence run drives shards and stages on a trigger; the free tier has no equivalent, so the draft is as far as it goes |
crystl sequence cancel |
Guild | ask the user to stop the run from the sequences drawer |
crystl stage complete |
Guild | a sequence run drives shards and stages on a trigger; the free tier has no equivalent, so the draft is as far as it goes |
crystl stage blocked |
Guild | a sequence run drives shards and stages on a trigger; the free tier has no equivalent, so the draft is as far as it goes |
crystl stage nothing |
Guild | a sequence run drives shards and stages on a trigger; the free tier has no equivalent, so the draft is as far as it goes |
crystl stage-mcp |
Guild | a sequence run drives shards and stages on a trigger; the free tier has no equivalent, so the draft is as far as it goes |
crystl worktree target show |
free | works |
crystl worktree target set |
Guild | ask the user to set it in settings → shards |
crystl worktree target quest-branch |
Guild | ask the user to set it in settings → shards |
crystl worktree target reset |
Guild | ask the user to set it in settings → shards |