## What are facet inserts?

Facet Inserts are saved prompts stored in 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`](/content/docs/cli/index.html) (Guild-gated, since they mutate your setup).

## Prompt library integration

Every plan gets the [Prompt Library](/content/prompts/index.html): 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 | Full access | Full access |

Facet Inserts are available on every plan, including the free one, so you can save your most-used prompts from day one. The Prompt Library is free on every plan too.

## 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.