All pages

Lesson 4.5 · Automate · 8 min

Custom shortcuts

Bind a key chord to a prompt, a runbook, or text sent to the terminal.

Listen

After this lesson you can bind a key chord to a saved prompt, a runbook, a screenshot, or text sent to the terminal, and make the chord work even when another app is in front.

Time: 8 minutes · Works on: macOS app.

Custom shortcuts vs. keybindings

TRMNLY has two settings panes for keys. They do different jobs.

  • Settings → Keybindings changes the keys for the terminal's built-in actions, such as new tab, copy or split.
  • Settings → Shortcuts creates new chords that run TRMNLY actions: a prompt, a runbook, some text, a screenshot or a file picker.

This lesson is about the second.

The four you already have

TRMNLY sets up four shortcuts on first launch:

Chord Action Works
⌃⌘S Screenshot to Chat From any app
⌃⇧⌘S Screenshot to Terminal From any app
⌘P Show Prompt Menu In TRMNLY
⌃⌘A Attach File to Terminal In TRMNLY

Try one now. Press ⌃⌘S while another app is in front and drag over part of the screen. TRMNLY comes forward with the capture in the agent's message box, ready for you to add a question and send.

You can change or delete any of these. A default you delete is never added back.

Make your own

Bind a chord that sends a saved prompt to the agent:

  1. Save a prompt first, for example "Review the uncommitted diff and list anything risky." See Saved prompts.
  2. Open Settings → Shortcuts and click Add Shortcut.
  3. Type a Name, such as "Review diff".
  4. Click Record and press a chord, such as ⌃⌥R. The order you press the modifiers in doesn't matter.
  5. Set Action to Run Saved Prompt and pick the prompt.
  6. Click Save.

Press the chord in a terminal window. The prompt goes to that window's agent, with its variables filled in.

A quicker route for prompts: right-click a prompt in the Prompts tab and choose Assign Shortcut….

What a shortcut can do

Action Does
Send Text Types text into the focused pane. Turn on Press Return after (run the command) to run it.
Run Saved Prompt Sends a saved prompt to the agent in the focused window
Run Runbook Starts a runbook in a new agent session
Screenshot to Chat Lets you select an area of the screen and puts the image in the agent's message box
Screenshot to Terminal Same selection, but types the image's path into the focused pane
Show Prompt Menu Shows your saved prompts as a menu at the terminal cursor
Attach File to Terminal Opens a file picker and types the chosen paths into the focused pane
Toggle Floating Pane Shows or hides a terminal floating above the split layout

Screenshot to Terminal and Attach File to Terminal type a path as @/path when a coding CLI such as Claude Code is running in the pane, and as a shell-escaped path otherwise. Nothing is sent: you add the rest and press Return.

Try Send Text: bind ⌃⌥G to the text git status with Press Return after (run the command) on. Now one chord runs it in whatever pane you're in.

Make a shortcut work everywhere

Turn on Fire even when TRMNLY isn't focused (global) to make a chord work while another app is in front. This is most useful for the screenshot actions.

Global shortcuts need macOS Accessibility permission. If one isn't firing, the Shortcuts pane shows a banner with Open System Settings. Turn TRMNLY on under Privacy & Security → Accessibility.

When chords collide

If a new chord is already used by another custom shortcut, a keybinding, or a menu item, TRMNLY shows Shortcut conflict and asks before saving. Choose Use Anyway only if you mean to replace the other one.

If a shortcut has nothing to act on, such as no terminal window or a prompt you since deleted, TRMNLY beeps instead of failing silently.

Check yourself

  • ⌃⌘S from another app put a screenshot in the agent's message box.
  • Your new chord sent a saved prompt to the agent.
  • A Send Text shortcut ran a command in the focused pane.
  • You can say which settings pane to use to change the key for a new tab.

Go further