Reference
Keyboard shortcuts
Every keyboard shortcut in Codz for Mac, grouped by where you use it, from the command palette and composer to Git and issues.
These are the keyboard shortcuts Codz defines on the Mac. Most live in the menu bar, where you can also find them, and the command palette shows each action’s shortcut beside it.
The key that sends a message is the one shortcut you can change: Settings ▸ Keyboard shortcuts ▸ Send message switches between Return and ⌘ Return. That page also lists the main shortcuts for reference.
App and windows
| Shortcut | Action |
|---|---|
| ⌘, | Open Settings |
| ⌘N | New chat |
| ⌘⇧N | New project |
| ⌥⌘U | Show or hide the Activity view in the sidebar |
| ⌘W | Close the window |
| ⌘M | Minimize |
| ⌃⌘F | Enter full screen |
| ⌘H | Hide Codz |
| ⌥⌘H | Hide other apps |
| ⌘Q | Quit Codz |
Command palette and search
| Shortcut | Action |
|---|---|
| ⌘K | Open the command palette. Press again to close it |
| ⌘P | Go to a file in the current project. Press again to move down the list |
| ⌘⇧P | Run a command |
| ⌘[ / ⌘] | In the palette, step through All, Chats, Files, Actions and Settings |
> / @ | In an empty palette, switch to Actions / Chats |
| ↑ / ↓ | Move the selection. ⌃N and ⌃J move down, ⌃P and ⌃K move up |
| ↩ | Open the selected result |
| Esc | Close the palette |
| ⌘F | Find in the file editor, in a Browser page that has focus, or in the conversation on screen. Elsewhere, filter the sidebar’s chats |
| ⌘⇧F | Filter the sidebar’s chats, archived ones included |
Codz ▸ Search Chats… opens the palette on Chats. It has no shortcut of its own.
Navigation
The number keys open the dashboard’s pages, listed in Settings ▸ Keyboard shortcuts as ⌘1…9:
| Shortcut | Action |
|---|---|
| ⌘[ | Back |
| ⌘] | Forward |
| ⌘1 | Overview |
| ⌘2 | Agents |
| ⌘3 | Ports |
| ⌘4 | Usage |
| ⌘5 | Models |
| ⌘7 | Chat |
| ⌘8 | Profile |
| ⌘9 | Storage |
| ⌘0 | Memory |
| ⌘⇧I | Issues |
When a page in the Browser panel has focus, ⌘[ and ⌘] go back and forward in that page instead.
Chats
| Shortcut | Action |
|---|---|
| ⌘/ | Change model: open the composer’s model picker. ⌘⇧M also works |
| ⌃⌘1…9 | Switch the chat to model 1 to 9 in your loadout |
| ⌥⌘/ | Cycle the model’s effort levels |
| ⌘⇧E | Turn Fast mode on or off, where the model has one |
| ⌘⇧A | Open or close the side chat |
| ⌘⇧C | Copy the conversation |
| ⌘L | Focus the composer |
| ⌘. | Stop generating |
| ⌥↑ / ⌥↓ | Jump to your previous / next message in the conversation |
| ← / → | In an opened image, show the previous / next image. Esc closes it |
See Models & loadout and Handoffs & side chats.
Composer
| Shortcut | Action |
|---|---|
| ↩ | Send the message |
| ⇧↩ | Start a new line |
| ⌘↩ | Send, when Send message is set to ⌘ Return. ↩ then starts a new line |
| ⌘↩ while the agent works | Send your message into the running turn, for agents that accept it. Needs Return as the send key |
| Esc while the agent works | Stop the turn |
| ⇧Tab | Cycle the mode: Ask, Plan, Agent |
| ↑ / ↓ | Move through @ and / suggestions |
| Tab | Accept the highlighted suggestion, or move focus out of the composer |
| ⌥Tab | Type a tab |
| Esc | Close the model picker, the suggestions or the plan checklist; otherwise leave the composer |
When an action waits for approval
| Shortcut | Action |
|---|---|
| ⌘↩ | Approve the action |
| Esc | Deny it |
| Type a reason, then ↩ | Deny it, with your reason for the agent |
Plain ↩ never approves an action. Chat ▸ Approve Action and Chat ▸ Deny Action have no shortcuts of their own: approving from the keyboard works only in the composer. See Modes & approvals.
When an agent asks a question
The question takes the composer’s place.
| Shortcut | Action |
|---|---|
1…9 | Pick an answer |
| ↑ / ↓ | Move the highlight |
| Space | Choose the highlighted answer |
| ← / → | Previous / next question |
| ↩ | Go to the next question, or Submit |
| Esc | Skip |
In the model picker
| Shortcut | Action |
|---|---|
| ↑ / ↓ | Move through the list |
Home / End | First / last row |
| → / ← | Open / close the effort or account menu |
| ↩ or Space | Choose |
| Esc | Close the picker |
Workspace
⌘⇧1…7 open the seven panels of the workspace beside a chat:
| Shortcut | Action |
|---|---|
| ⌘⇧1 | Activity |
| ⌘⇧2 | Git |
| ⌘⇧3 | Terminal |
| ⌘⇧4 | Files |
| ⌘⇧5 | Browser, with Browser tools on |
| ⌘⇧6 | Computer, with Computer use on |
| ⌘⇧7 | Run, in a project Codz can run |
| ⌘⇧8 | Background tasks |
| ⌘⇧0 | Close the workspace |
| ⌃` | Open or close the terminal drawer |
| ⌥⌘B | Show or hide the panel |
| ⌘R | Run the project in the Run panel where there is one; otherwise refresh agent activity and usage |
| ⌘B | Build the app, in an iOS or Android project |
| ⌘⇧. | Stop the running app, in an iOS or Android project |
See Workspace and Run & previews.
Browser panel
With Browser tools on:
| Shortcut | Action |
|---|---|
| ⌘= | Zoom in |
| ⌘- | Zoom out |
| ⌥⌘I | Show or hide the Web Inspector |
| ⌘⇧D | Enter or exit Design Mode |
| ⌘F | Find in the page, when it has focus |
| ⌘R | Reload the page, when it has focus |
Files panel
In the file tree:
| Shortcut | Action |
|---|---|
| ↑ / ↓ | Move through the tree. Add ⇧ to extend the selection |
| ← / → | Collapse / expand a folder. Add ⌥ to include every folder inside it |
| ⌘↓ or Space | Open the file or folder |
| ↩ | Rename |
| ⌘D | Duplicate |
| ⌘⌫ | Move to Trash |
| ⌘C / ⌘X / ⌘V | Copy, cut and paste files |
| ⌘Z | Undo the last file operation |
| Esc | Clear the selection |
Home / End, Page Up / Page Down | Jump through the tree |
Typing a name selects the first match. In the editor:
| Shortcut | Action |
|---|---|
| ⌘L | Add the selected code to the chat |
| ⌃Space | Complete code with the file’s language server |
| ⌘F | Find in the file |
See Files.
Source control
| Shortcut | Action |
|---|---|
| ⌥⌘C | Commit |
| ⌥⌘⇧C | Amend last commit |
| ⌥⌘Z | Undo the last Git operation |
| ⌥⌘A | Stage all |
| ⌥⌘⇧A | Unstage all |
| ⌥⌘⌫ | Discard changes… |
| ⌥⌘E | Fetch |
| ⌥⌘⇧U | Pull |
| ⌥⌘P | Push |
| ⌘⇧B | New branch… |
| ⌥⌘1 | Show changes |
| ⌥⌘2 | Show history |
In the Git panel’s list of changes, ↑ and ↓ move, Space stages or unstages the file, and ↩ shows its diff. See Git & worktrees.
Issues
On the Issues page, while you are not typing in a field:
| Shortcut | Action |
|---|---|
| C | New issue |
| J / K or ↓ / ↑ | Move to the next / previous issue |
| ⇧↓ / ⇧↑ | Extend the selection |
| X | Select or deselect the focused issue |
| ⌘A | Select all issues |
| O or ↩ | Open the focused issue |
| Esc | Close the issue, or clear the selection |
| S | Set status |
| P | Set priority |
| A | Set assignee |
| L | Set labels |
| I | Assign to yourself, or unassign |
| ⇧D | Set due date |
| ⌘⇧P | Set parent issue |
| ⌘⇧O | New sub-issue |
| ⌥↑ / ⌥↓ | Move the issue up / down, in manual order |
| ⌘⌫ | Archive |
| ⌘. | Copy the issue’s identifier |
| ⌘⇧. | Copy its branch name |
| ⌘⇧, | Copy its link |
| F | Add a filter |
| ⇧F | Remove the last filter |
| ⌥⇧F | Clear all filters |
| ⇧V | Display options |
| ⌘B | Switch between list and board |
| ] | Show or hide details |
| G, then A, B or E | Go to Active, Backlog or All issues |
| W, then O | Work on it: start an agent on the issue |
In a new issue:
| Shortcut | Action |
|---|---|
| ⌘↩ | Create the issue |
| Tab / ⇧Tab | Move between fields |
| S, P, A, L | Status, priority, assignee, labels, outside the text fields |
| ⇧D | Due date |
| E | Go to the title |
| ⌘⇧P | Parent issue |
| ⌘⇧U | Attach a file |
| Esc | Cancel |
On an open issue, ⌘↩ posts a comment or saves the one you are editing, and ⌘⇧U attaches a file to the description or comment. See Issues.
Editing
| Shortcut | Action |
|---|---|
| ⌘Z / ⌘⇧Z | Undo / redo |
| ⌘X / ⌘C / ⌘V | Cut, copy, paste |
| ⌥⌘⇧V | Paste and match style |
| ⌘A | Select all |
| ⌘G / ⌘⇧G | Find next / previous |
| ⌥⌘F | Find and replace |