Facet Inserts

Updated July 31, 2026

What are facet inserts?

Facet Inserts are saved prompts that live inside your crystl configuration. Each insert has a label (what you see in the menu) and a body (the text that gets sent to your agent). Instead of retyping the same instructions, you fire them with one click from any shard.

Insert types

Facet Inserts come in two kinds:

  • Prompt: Natural-language instructions sent to your agent, like “fix this bug” or “write tests for this file”
  • Command: Slash commands or shell commands, typed into the terminal as-is

Each insert’s SHOW ON scope decides where it appears: all shards, open only (shared shards), or isolated only.

Adding a facet insert

  1. Open app Settings (Cmd+,) and choose Facet Inserts under Workspace.
  2. Click + new facet.
  3. Enter its label and text, then choose whether a click inserts or immediately submits it.
  4. Drag the facet into one of the slots on the right. Each slot becomes a button in the terminal’s facet bar.

The insert is available immediately across all your shards.

Using facet inserts

Click a slot button in the facet bar and its dropdown lists the inserts assigned to that slot. Click any insert to send it to the active shard.

The facet bar

The fastest surface is the facet bar: up to three buttons docked in the terminal (the count is set on the settings page), each a dropdown holding up to 8 inserts. Bind an insert to a slot and it’s one click (or one keystroke) away in every shard:

  • Cmd + Opt + 1, Cmd + Opt + 2, and Cmd + Opt + 3 fire the insert bound to bar slots 1–3 into the active shard.
  • Each insert’s action is either insert (drops the text in for you to review) or submit (runs it immediately).
  • Agents can manage the library and slots too, via crystl facet add/slot/remove (Guild-gated, since they mutate your setup).

Prompt library integration

Guild members get access to the Prompt Library: close to 400 ready-made prompts organized in categories including debugging, code review, git workflows, testing, API design, and more. Browse the library with search and category filters, find prompts that fit your workflow, and add them directly to your Facet Inserts.

Free vs Guild

Free Guild
Facet Inserts Yes Yes
Prompt Library None Full access

Facet Inserts are available on every plan, including the free one, so you can save your most-used prompts from day one. Guild members also get full Prompt Library integration.

Shared across gems

Facet Inserts are stored in your crystl configuration, not tied to a single gem. The same library is available in every project you open.