Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Smart Prompts Library

The Smart Prompts Library stores and manages all your prompt templates — both the 24 built-in AI automation prompts and your custom templates. Prompts are injected directly into the active agent terminal or run headless for quick one-shot operations.

Looking for one-click AI automation? See Smart Prompts for the full guide on built-in automation prompts, context variables, and headless execution.

Opening the Drawer

  • Cmd+Shift+K — Toggle the prompt library drawer
  • Toolbar button — Prompt library icon in the main toolbar

Browsing and Searching

When the drawer opens, the search input is focused automatically. Type to filter prompts by name, description, or content. Matching is case-insensitive and searches all three fields simultaneously.

Use the category tabs to narrow the list:

TabShows
AllEvery saved prompt, sorted by most recently used
CustomUser-created prompts
FavoritesPrompts you have starred
RecentLast 10 prompts you used

Keyboard Navigation

KeyAction
/ Move selection up/down
EnterInsert selected prompt into terminal
Double-clickInsert and immediately execute (adds newline)
Ctrl+N / Cmd+NCreate a new prompt
Ctrl+E / Cmd+EEdit the selected prompt
Ctrl+F / Cmd+FToggle favorite on the selected prompt
EscapeClose the drawer

Creating a Prompt

  1. Open the drawer (Cmd+Shift+K) and click + New Prompt, or press Ctrl+N/Cmd+N
  2. Fill in the fields:
    • Name (required) — shown in the list
    • Description — optional subtitle, also searchable
    • Content (required) — the text to insert; use {{variable}} for dynamic values
    • Keyboard Shortcut — optional global shortcut to trigger this prompt directly
  3. Click Save

Editing and Deleting

  • Click the pencil icon on any prompt row, or select it and press Ctrl+E/Cmd+E
  • Click the trash icon to delete — a confirmation dialog appears before deletion

Variable Substitution

Use {{variable_name}} placeholders in prompt content. When you send a prompt that contains variables, a dialog appears asking you to fill in each value before injection.

cd {{project_dir}} && cargo test -- {{test_filter}}

Built-in Variables

These are resolved automatically by the backend when present:

VariableValue
{{diff}}Current git diff
{{changed_files}}List of changed files
{{repo_name}}Repository name
{{branch}}Current branch name
{{cwd}}Current working directory

Custom Variables

Any {{name}} not in the built-in list becomes a custom input field in the variable dialog. You can optionally add a description and default value per variable when editing the prompt — the description appears as placeholder text in the dialog.

Inserting with Variables

The variable dialog offers two actions:

  • Insert — writes the resolved text to the terminal input line (you can review before pressing Enter)
  • Insert & Run — appends a newline, sending the command immediately

Favorites and Pinning

Click the star icon on any prompt row to toggle its favorite status. Favorited prompts appear at the top of any list view with a prefix and are accessible via the Favorites category tab.

Recently Used

The Recent tab shows the last 10 prompts you sent, in order of use. Recency is also used to sort the All view — most recently used prompts appear first.

Sending to Terminal

Selecting a prompt (click or Enter) writes its content to the currently active terminal. If the prompt has no variables, it is injected immediately. If it does, the variable dialog appears first.

The drawer closes automatically after a successful injection and focus returns to the terminal.


Run Commands

A lighter-weight alternative for per-branch one-off commands:

  • Cmd+R — Run the saved command for the active branch
  • Cmd+Shift+R — Edit the command before running

Configure run commands in Settings → Repository → Scripts tab.