# ⚡ Keyboard Shortcuts

This guide lists all available keyboard shortcuts for the Acode AI CLI Assistant Plugin to help you work more efficiently.

## 🎯 Main Shortcuts

### AI Assistant Access
| Shortcut | Action | Description |
|----------|--------|-------------|
| `Ctrl/Cmd + Shift + P` | Open Renz Ai | Opens the main AI chat interface |

### Code Selection Actions
| Shortcut | Action | Description |
|----------|--------|-------------|
| `Ctrl/Cmd + E` | Explain Code | Explains selected code or entire file if nothing selected |
| `Ctrl/Cmd + Shift + R` | Rewrite Code | Rewrites selected code with AI assistance |
| `Ctrl/Cmd + Shift + O` | Optimize Function | Optimizes selected function for better performance |
| `Ctrl/Cmd + Shift + C` | Add Comments | Adds comments to selected code for better documentation |
| `Ctrl/Cmd + Shift + D` | Generate Docs | Generates documentation for selected code or entire file |
| `Ctrl/Cmd + Shift + G` | Generate Code | Generates new code based on your description |

### File Operations
| Shortcut | Action | Description |
|----------|--------|-------------|
| `Ctrl/Cmd + Shift + E` | Edit File with AI | Opens AI edit interface for current file |
| `Ctrl/Cmd + Shift + B` | Bulk Operations | Opens bulk file operations menu |
| `Ctrl/Cmd + Shift + P` | Command Palette | Opens AI command palette for various features |

## 📱 Chat Interface Shortcuts

### Message Input
| Shortcut | Action | Description |
|----------|--------|-------------|
| `Ctrl/Cmd + Enter` | Send Message | Sends your message to the AI (same as clicking Send button) |
| `Shift + Enter` | New Line | Creates a new line in the input box without sending |

### Navigation
| Shortcut | Action | Description |
|----------|--------|-------------|
| `Escape` | Close Assistant | Closes the AI assistant interface |
| `Up Arrow` | Previous Message | Accesses your previous message in the input box |
| `Down Arrow` | Next Message | Accesses your next message in the input box |

## 📁 File Management Shortcuts

### Within Bulk Operations
| Shortcut | Action | Description |
|----------|--------|-------------|
| `Ctrl/Cmd + A` | Select All | Selects all files in the current directory |
| `Ctrl/Cmd + Click` | Toggle Selection | Toggles selection of individual files |
| `Shift + Click` | Range Selection | Selects a range of files between two clicks |

## 🎨 UI Customization Shortcuts

### Theme Adjustments
| Shortcut | Action | Description |
|----------|--------|-------------|
| `Ctrl/Cmd + Shift + T` | Toggle Theme | Switches between light and dark themes (if supported) |

## ⚙️ Advanced Shortcuts

### Terminal Integration
| Shortcut | Action | Description |
|----------|--------|-------------|
| `Ctrl/Cmd + Alt + T` | AI Terminal | Opens AI-assisted terminal command interface |

### Real-Time Analysis
| Shortcut | Action | Description |
|----------|--------|-------------|
| `Ctrl/Cmd + Shift + L` | Toggle Real-Time | Enables/disables real-time code analysis |

### History Management
| Shortcut | Action | Description |
|----------|--------|-------------|
| `Ctrl/Cmd + Shift + H` | Chat History | Opens conversation history browser |

## 📋 Shortcut Customization

### Modifying Shortcuts
The plugin allows you to customize keyboard shortcuts:
1. Open Acode Settings
2. Navigate to Plugins → AI CLI Assistant
3. Access the shortcuts configuration panel
4. Modify key bindings as needed

### Default vs Custom Shortcuts
- Default shortcuts are optimized for common usage patterns
- Custom shortcuts can be set to match your workflow preferences
- Conflicts with existing Acode shortcuts are automatically detected

## 🐛 Troubleshooting Shortcut Issues

### Common Problems

#### Shortcuts Not Working
- Ensure the plugin is properly enabled
- Check that shortcuts don't conflict with system or Acode shortcuts
- Restart Acode to refresh shortcut bindings

#### Shortcut Conflicts
- Acode or system may override plugin shortcuts
- Modify conflicting shortcuts in plugin settings
- Use alternative key combinations

#### Device-Specific Issues
- Some keyboards may not support certain key combinations
- Touch devices may have different shortcut behaviors
- Tablet vs phone layouts may affect shortcut availability

### Shortcut Verification

To verify shortcuts are working:
1. Try `Ctrl/Cmd + Shift + A` to open AI assistant
2. Select some code and try `Ctrl/Cmd + E` to explain it
3. Check that chat interface responds to `Ctrl/Cmd + Enter`

## 💡 Best Practices

### Learning Shortcuts
1. Start with the most essential shortcuts (`Ctrl/Cmd + Shift + A`, `Ctrl/Cmd + E`)
2. Gradually incorporate more advanced shortcuts into your workflow
3. Practice using shortcuts regularly to build muscle memory

### Efficient Shortcut Use
1. Combine shortcuts with selection for targeted AI assistance
2. Use `Ctrl/Cmd + Shift + P` for access to all plugin features
3. Customize shortcuts to match your existing workflow

### Shortcut Memory Aids
- All AI-related shortcuts use `Shift` modifier
- Code action shortcuts use `Ctrl/Cmd + Shift + [letter]`
- File management shortcuts use `Ctrl/Cmd + Shift + [letter]`

## 📞 Getting Help

If you encounter issues with keyboard shortcuts:
1. Check the [Common Issues](Common-Issues.md) documentation
2. Visit our [GitHub Issues](https://github.com/RenzMc/Acode-Plugin-AI-cli/issues) page
3. Join our [Discussions](https://github.com/RenzMc/Acode-Plugin-AI-cli/discussions) community for support

---

<div align="center">

[🏠 Home](Home.md) | [⬆ Back to Top](#-keyboard-shortcuts) | [🎨 Theme Customization](Theme-Customization.md)

</div>