Skip to content

Pinned Prompts

Pinned prompts are named shortcuts that appear as clickable pills above the chat composer. Use them to send recurring instructions, slash commands, or multi-line prompts in a single click — without retyping or scrolling through history.

When at least one pinned prompt is configured, a row of pills appears above the chat input. Each pill shows the prompt’s display name. Clicking a pill either sends the prompt immediately or inserts it into the composer, depending on whether Auto-send when clicked is enabled.

Chat composer with a row of pinned prompt pills above the message input

Each pinned prompt has an Auto-send when clicked toggle (referred to as Auto-send below for brevity):

ModeBehavior
Auto-send onClicking the pill sends the prompt immediately, as if you had typed it and pressed Enter
Auto-send offClicking the pill inserts the prompt text into the composer so you can review or edit before sending

Use auto-send for prompts you always want to run as-is. Leave it off for templates you customize each time.

Each pinned prompt can also carry an opinion about the four chat-toolbar toggles:

  • Plan mode
  • Fast mode
  • Thinking
  • Claude in Chrome

Each override is tri-state: Inherit, On, or Off.

The Plan mode override follows the active runtime: Claude-compatible sessions start with Claude Code’s plan approval flow, while Codex Native sessions start with Codex’s plan collaboration mode.

SettingBehavior on click
Inherit (default)The toolbar toggle is left at whatever you’ve selected for the session
OnThe toolbar toggle is flipped on before the prompt runs
OffThe toolbar toggle is flipped off before the prompt runs

Overrides are applied to the live toolbar — the change is sticky, not per-turn. After clicking the pinned prompt, the toolbar shows the new state and follow-up turns inherit it until you flip the toggle back yourself.

A typical use: an “Incorporate feedback” prompt that must run outside plan mode can pin Plan mode: Off, so clicking the pill always disables plan mode before sending — even if you forgot the toolbar was still on plan.

Overrides apply whether Auto-send is on or off. With auto-send off you’ll see the toolbar update before you edit the inserted prompt.

When creating or editing a pinned prompt, the prompt body field supports the same / slash command picker as the main chat composer. Type / to open the picker and select a command to insert it.

This lets you build prompts that combine slash commands with custom context — for example, a “Review changes” prompt that runs /review followed by project-specific instructions.

Global pinned prompts appear in every repository. Manage them at Settings → Pinned Prompts.

Global Pinned Prompts settings page showing several saved prompts with edit, reorder, and add controls

To create a global prompt:

  1. Open Settings → Pinned Prompts
  2. Click Add prompt
  3. Enter a Display name (shown on the pill) and the Prompt body
  4. Toggle Auto-send on or off
  5. Under Toolbar overrides, set each toggle — Plan mode, Fast mode, Thinking, Claude in Chrome — to Inherit, On, or Off (see Toolbar Overrides above; leave them on Inherit if the prompt doesn’t care)
  6. Click Save

Use the and buttons to reorder prompts within the list. Order is preserved in the pill bar.

In the prompt list, a prompt that forces any toggle shows small chips (e.g. Plan mode: Off) next to its name, alongside the Auto-send indicator.

Each repository can have its own pinned prompts that appear only when working in that repo. Manage them at Settings → [Repository Name] → Pinned Prompts.

Repository settings page with a Pinned Prompts section and an Inherited from Global list below it

Repo prompts appear before global prompts in the pill bar. See Per-Repo Settings for other repository-level configuration.

Repositories inherit all global pinned prompts automatically. If a repo defines a prompt with the same display name as a global prompt, the repo’s version takes precedence and the global one is hidden.

In repo settings, inherited global prompts are listed below the repo-specific prompts. Any global prompt that is being overridden by a repo prompt of the same display name shows an Overridden badge.

This lets you define a common baseline globally while tailoring specific prompts per project — for example, a global “Run tests” prompt that a repo overrides with its specific test command.