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.
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:
- Save a prompt first, for example "Review the uncommitted diff and list anything risky." See Saved prompts.
- Open Settings → Shortcuts and click Add Shortcut.
- Type a Name, such as "Review diff".
- Click Record and press a chord, such as
⌃⌥R. The order you press the modifiers in doesn't matter. - Set Action to Run Saved Prompt and pick the prompt.
- 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
⌃⌘Sfrom 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
- Custom shortcuts — attaching files to a pane, and how each action picks its target
- Keybinds — rebinding the terminal's built-in actions
- Workflows and tab monitors — the runbooks a shortcut can start