Facet Inserts

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 support three types:

• Prompt: Natural-language instructions sent to your agent, like “fix this bug” or “write tests for this file”
• Command: Slash commands or CLI invocations that run directly
• Shortcut: Quick actions for common workflows like committing, rebasing, or running tests

Adding a facet insert

1. Open the gem menu (the ⋮ on the gem’s tab, or a double-click on its tile in the Crystal Rail) and choose settings
2. Navigate to the Facet Inserts section
3. Click Add Insert
4. Enter a label and the prompt body
5. Choose a type (prompt, command, or shortcut)
6. Optionally assign a category to keep things organized

The insert is available immediately across all your shards.

Using facet inserts

Open the Facet Insert menu from the shard toolbar. Your inserts are grouped by category. Click any insert to send it directly to the active shard.

The facet bar

The fastest surface is the facet bar: three buttons docked in the terminal, 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).

Organizing by category

Assign categories to group related inserts: by task type (debug, refactor, test), by project convention, or however fits your workflow. Categories keep the menu clean as your library grows.

Prompt library integration

Guild members get access to the Prompt Library: 200 ready-made prompts organized across 20 categories including debugging, code review, git workflows, testing, API design, and more. Browse the library, 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.