Keyboard Shortcuts
TatsuCode is designed for keyboard-first interaction. Learn these shortcuts to work faster.
Chat Input
| Shortcut | Action |
|---|---|
| Enter | Send message |
| Shift + Enter | Insert newline (don't send) |
| Tab | Accept command/file suggestion |
| Escape | Cancel current AI operation |
| Ctrl + V | Paste text or images |
Command Suggestions
Type / to open the command dropdown:
| Shortcut | Action |
|---|---|
| / | Show command suggestions |
| Arrow Up/Down | Navigate suggestions |
| Enter | Select suggestion |
| Tab | Accept and autocomplete |
| Escape | Close dropdown |
| Type | Filter suggestions |
File References
Type @ to reference files quickly:
| Shortcut | Action |
|---|---|
| @ | Open file picker |
| Arrow Up/Down | Navigate files |
| Enter | Insert file reference |
| Tab | Accept and autocomplete |
| Escape | Close file picker |
| Type | Filter by filename |
Example usage:
> Explain @config.json
> Compare @src/old.ts with @src/new.tsFiles referenced with @ are automatically read into context.
Permission Dialogs
When TatsuCode asks for permission:
| Shortcut | Action |
|---|---|
| 1 | Allow once |
| 2 | Allow for this session |
| 3 | Always allow |
| 4 | Deny |
| Y or Enter | Allow (default option) |
| N or Escape | Deny |
Modal Windows
When dialogs or dropdowns are open:
| Shortcut | Action |
|---|---|
| Tab | Move to next element |
| Shift + Tab | Move to previous element |
| Enter or Space | Activate focused button |
| Escape | Close modal |
| Arrow Keys | Navigate options |
Navigation
| Shortcut | Action |
|---|---|
| Page Up | Scroll up |
| Page Down | Scroll down |
| Ctrl + Home | Scroll to top |
| Ctrl + End | Scroll to bottom |
Zoom
Adjust the interface size:
| Shortcut | Action |
|---|---|
| Ctrl + Mouse Wheel | Zoom in/out |
| Ctrl + Plus | Zoom in |
| Ctrl + Minus | Zoom out |
| Ctrl + 0 | Reset zoom |
Quick Command Reference
Common commands you'll use often:
| Type | Command |
|---|---|
/new | Start new session |
/clear | Clear conversation |
/models | Change AI model |
/connect | Manage providers |
/providers | Alias of /connect |
/usage | Token usage |
/compact | Compress context |
/session | Load session |
/theme | Change theme |
/temp 0.7 | Set temperature |
/exit | Close TatsuCode |
Tips for Speed
Use Tab Completion
After typing /mod, press Tab to autocomplete to /models.
Use @ for Files
Instead of asking "read the config file", type @config.json and it's automatically included.
Number Keys for Permissions
When permission dialogs appear, press 1, 2, 3, or 4 instead of clicking buttons.
Escape to Cancel
Press Escape anytime to:
- Stop AI generation
- Close dropdowns/modals
- Cancel permission prompts
- Clear suggestions
Accessibility
TatsuCode supports full keyboard navigation:
- Tab moves between interactive elements
- Enter activates buttons and links
- Arrow keys navigate lists and dropdowns
- Escape closes overlays and cancels operations
- Screen reader compatible
Next Steps
- Commands — Full command reference
- Settings — Configure TatsuCode
- Quickstart — Get started guide