CLI command tiers · crystl Docs

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.

Five deliberate exceptions apply 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).
Your own identity is free.crystl identity update and crystl identity edit change and open the description of you that your agents read. It is yours, it stays on your Mac, and every agent needs it on every tier.
Telling us about a bug is free.crystl report bug, idea, and praise.
Describing your own machine is free.crystl agent profile set and crystl endpoint set / remove record 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 add and crystl schedule cancel are 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 add answers 403 limit_reached rather than guild_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 be tier-specific:

Your project’s CLAUDE.md / AGENTS.md gets 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 written for 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. Turning off tell agents about the crystl CLI takes it out, and so does crystl uninstall.

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

178 commands: 97 free on every tier, 81 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 identity show`	free	works
`crystl identity update`	free	works
`crystl identity edit`	free	works
`crystl activity open`	free	works
`crystl usage`	free	works
`crystl servers list`	free	works
`crystl servers stop`	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 agent account list`	free	works
`crystl agent account add`	free	works
`crystl agent account remove`	free	works
`crystl endpoint list`	free	works
`crystl endpoint set`	free	works
`crystl endpoint remove`	free	works
`crystl model context list`	free	works
`crystl model context set`	free	works
`crystl model context 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 dispatch cancel`	Guild	ask the user to clear that shard’s input line (ctrl-u), which releases the held message instead of dropping it
`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 links list`	free	works
`crystl links open`	free	works
`crystl links add`	Guild	edit LINKS.md in the project directly
`crystl links edit`	Guild	edit LINKS.md in the project directly
`crystl links move`	Guild	edit LINKS.md in the project directly
`crystl links remove`	Guild	edit LINKS.md in the project directly
`crystl links group add`	Guild	edit LINKS.md in the project directly
`crystl links group rename`	Guild	edit LINKS.md in the project directly
`crystl links group move`	Guild	edit LINKS.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 where`	free	works
`crystl keys list`	free	works
`crystl keys note`	free	works
`crystl keys request`	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 sequence stop`	Guild	ask the user to stop the run from the sequences drawer
`crystl sequence resume`	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 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