# fac Keybindings Reference

Complete keyboard shortcut reference for `fac` editor.

---

## 🔍 LSP Features

| Keybinding | Command | Description |
|------------|---------|-------------|
| `F12` or `Ctrl+\` or `Alt+G` | Go to Definition | Jump to where a symbol is defined |
| `Shift+F12` or `Alt+R` | Find References | Find all usages of a symbol |
| `F2` | Rename Symbol | Rename symbol across entire project |
| `F10` or `Alt+.` | Code Actions | Quick fixes and refactorings |
| `F8` or `Alt+E` | Diagnostics Panel | Show all errors and warnings |
| `F4` or `Alt+O` | Document Symbols | Navigate symbols in current file |
| `F6` or `Alt+P` | Workspace Symbols | Search symbols across all files |
| `Ctrl+P` | Command Palette | Search and execute any command |
| `Shift+Alt+F` | Format Document | Auto-format current file |
| `Alt+,` | Jump Back | Return to previous location (jump stack) |

---

## 📁 File Operations

| Keybinding | Command | Description |
|------------|---------|-------------|
| `Ctrl+S` | Save | Save current file |
| `Ctrl+Q` | Quit | Exit editor (prompts if unsaved) |
| `Ctrl+O` | Open File | Open file browser (Fortress mode) |
| `Ctrl+N` | New File | Create new untitled buffer |
| `Ctrl+T` | New Tab | Create new empty tab |

---

## 📝 Editing

| Keybinding | Command | Description |
|------------|---------|-------------|
| `Ctrl+D` | Select Next Match | Add cursor at next occurrence of selection |
| `Ctrl+Z` | Undo | Undo last change |
| `Ctrl+Y` | Redo | Redo last undone change |
| `Ctrl+X` | Cut | Cut selection to clipboard |
| `Ctrl+C` | Copy | Copy selection to clipboard |
| `Ctrl+V` | Paste | Paste from clipboard |
| `Ctrl+A` | Select All | Select entire file |
| `Alt+Backspace` | Delete Word | Delete word backward |
| `Backspace` | Delete Char | Delete character backward |
| `Delete` | Delete Forward | Delete character forward |

---

## 🔎 Search & Replace

| Keybinding | Command | Description |
|------------|---------|-------------|
| `Ctrl+F` | Search | Open unified search/replace prompt |
| `Ctrl+H` | Replace | Open unified search/replace (same as Ctrl+F) |
| `Ctrl+G` | Go to Line | Jump to specific line number |
| **In Search Mode:** | | |
| `n` or `Ctrl+N` | Next Match | Jump to next search result |
| `N` or `Ctrl+P` | Previous Match | Jump to previous search result |
| `r` | Replace One | Replace current match |
| `a` | Replace All | Replace all matches |
| `Ctrl+R` | Toggle Regex | Enable/disable regex search |
| `Ctrl+C` | Toggle Case | Toggle case-sensitive search |
| `Ctrl+W` | Toggle Whole Word | Toggle whole-word matching |
| `Alt+S` | Search in Selection | Limit search to selected text |
| `↑` / `↓` | History | Navigate search history |
| `Esc` | Exit Search | Close search prompt |

---

## 🗂️ Tabs & Windows

| Keybinding | Command | Description |
|------------|---------|-------------|
| `Ctrl+T` | New Tab | Create new empty tab |
| `Ctrl+W` | Close Tab/Pane | Close current pane (then tab if last pane) |
| `Ctrl+PageDown` or `Ctrl+Alt+Right` | Next Tab | Switch to next tab |
| `Ctrl+PageUp` or `Ctrl+Alt+Left` | Previous Tab | Switch to previous tab |
| `Alt+1` to `Alt+9` (or `Ctrl+1` to `Ctrl+9`) | Jump to Tab | Switch to specific tab number |
| `Alt+V` | Split Vertical | Split current pane vertically |
| `Alt+S` | Split Horizontal | Split current pane horizontally |
| `Alt+Q` | Close Pane | Close current pane only |
| `Alt+H` or `Ctrl+Shift+Left` | Navigate Left | Move to pane on the left |
| `Alt+L` or `Ctrl+Shift+Right` | Navigate Right | Move to pane on the right |
| `Alt+K` or `Ctrl+Shift+Up` | Navigate Up | Move to pane above |
| `Alt+J` or `Ctrl+Shift+Down` | Navigate Down | Move to pane below |

---

## 🧭 Navigation

| Keybinding | Command | Description |
|------------|---------|-------------|
| `↑` `↓` `←` `→` | Move Cursor | Move cursor one character/line |
| `Alt+↑` | Move Line Up | Move current line up |
| `Alt+↓` | Move Line Down | Move current line down |
| `Home` or `Ctrl+A` | Line Start | Jump to beginning of line (smart toggle) |
| `End` or `Ctrl+E` | Line End | Jump to end of line |
| `Ctrl+Home` | File Start | Jump to beginning of file |
| `Ctrl+End` | File End | Jump to end of file |
| `Alt+←` / `Alt+→` | Word Jump | Move cursor by word |
| `Page Up` / `Page Down` | Page Scroll | Move up/down one screen |
| `Alt+[` / `Alt+]` | Match Bracket | Jump to matching bracket/paren |

---

## ✂️ Selection

| Keybinding | Command | Description |
|------------|---------|-------------|
| `Shift+↑↓←→` | Select | Extend selection with arrow keys |
| `Ctrl+Shift+Home` | Select to Start | Select from cursor to file start |
| `Ctrl+Shift+End` | Select to End | Select from cursor to file end |
| `Ctrl+A` | Select All | Select entire file |
| `Ctrl+D` | Select Next | Add cursor at next match of selection |
| `Esc` | Clear Selection | Deselect and return to single cursor |

---

## 🎨 Command & Utility

| Keybinding | Command | Description |
|------------|---------|-------------|
| `Ctrl+P` | Command Palette | Search and execute any command |
| `Ctrl+?` or `Ctrl+/` | Help | Show help screen |
| `Ctrl+B` or `F3` | File Tree | Toggle file explorer (Fuss mode) |
| `Ctrl+L` | Redraw Screen | Clear and redraw the screen |
| `Esc` | Cancel/Close | Close panels, cancel operations |

---

## 📋 Clipboard & Yank Stack

| Keybinding | Command | Description |
|------------|---------|-------------|
| `Ctrl+X` | Cut | Cut selection and add to yank stack |
| `Ctrl+C` | Copy | Copy selection to clipboard |
| `Ctrl+V` | Paste | Paste from clipboard |
| `Ctrl+Shift+V` | Yank Cycle | Cycle through clipboard history |

---

## 🌲 File Tree (Fuss Mode)

| Keybinding | Command | Description |
|------------|---------|-------------|
| `Ctrl+B` or `F3` | Toggle Tree | Show/hide file tree |
| **In Tree:** | | |
| `j` `k` or `↑` `↓` | Navigate | Move to previous/next sibling |
| `→` / `←` | Enter/Exit | Enter directory or exit to parent |
| `Enter` or `o` | Open | Open file in editor |
| `Space` | Toggle Expand | Expand/collapse directory |
| `?` | Show Hints | Display fuss mode keybindings |
| `Esc` | Close Tree | Hide file tree |

---

## 🎯 Multiple Cursors

| Keybinding | Command | Description |
|------------|---------|-------------|
| `Ctrl+D` | Select Word & Next | Select word under cursor, add cursor at next match |
| `Alt+Click` | Add/Remove Cursor | Add or remove cursor at mouse position |
| `Ctrl+Alt+↑` | Add Cursor Above | Add cursor on line above |
| `Ctrl+Alt+↓` | Add Cursor Below | Add cursor on line below |
| `Esc` | Single Cursor | Return to single cursor mode |
| *(while multiple cursors active)* | | |
| Type normally | Edit All | Type at all cursor positions |
| Arrow keys | Move All | Move all cursors together |
| `Backspace`/`Delete` | Delete All | Delete at all cursors |

---

## 📦 Panel Navigation

When any panel is open (Diagnostics, References, Symbols, etc.):

| Keybinding | Command | Description |
|------------|---------|-------------|
| `↑` `↓` or `j` `k` | Navigate Items | Move selection up/down |
| `Enter` | Select/Jump | Jump to selected item |
| `Esc` | Close Panel | Close the panel |
| Type characters | Filter/Search | Narrow down results (in symbols panels) |

---

## ⚙️ Special Modes

### Search/Replace Mode
Active when `Ctrl+F` (search) or `Ctrl+R` (replace) is pressed:
- `n` - Next match
- `N` - Previous match
- `Alt+C` - Toggle case sensitive
- `Alt+W` - Toggle whole word match
- `↑` / `↓` - Navigate search history
- `Esc` - Exit search mode

### Fuss (File Tree) Mode
Active when `Ctrl+B` or `F3` is pressed:
- `j` / `k` - Move to previous/next sibling
- `→` / `←` - Enter directory / exit to parent
- `Enter` or `o` - Open file
- `Space` - Toggle expand/collapse
- `?` - Show hints
- `Esc` - Exit Fuss mode

**Git operations in Fuss mode:**
- `a` - Stage file
- `u` - Unstage file
- `d` - Diff file
- `m` - Commit with message
- `p` - Push to remote
- `f` - Fetch from remote
- `l` - Pull from remote
- `t` - Create and push tag

---

## 💡 Tips

### Keybinding Conflicts
- Some keybindings may conflict with terminal emulator shortcuts
- If a key doesn't work, check your terminal's keyboard settings
- Common conflicts: F-keys (media controls), `Ctrl+W` (close terminal tab)
- All LSP features have Alt+key alternatives that work better in terminals

### Terminal Compatibility
Most terminal emulators don't pass Ctrl+Shift combinations reliably. That's why `fac` uses Alt+key alternatives:
- `Alt+E` instead of Ctrl+Shift+D for diagnostics
- `Alt+O` instead of Ctrl+Shift+O for document symbols
- `Alt+P` instead of Ctrl+Shift+T for workspace symbols
- `Alt+R` instead of Ctrl+Shift+R for references

### Discovering Commands
- Use `Ctrl+P` (Command Palette) to see all available commands
- Press `Ctrl+/` or `Ctrl+?` to see the help screen

### Vim Users
Some vim-style keybindings work:
- `j` / `k` - Up/down in panels and file tree
- `Alt+H/J/K/L` - Navigate between panes
- `o` - Open file in file tree
- Navigation in Fuss mode is sibling-based like vim's file explorers

---

## 🚀 Most Useful Combos

**Exploring code:**
1. `F6` or `Alt+P` - Find any symbol in project
2. `F12` or `Alt+G` - Jump to definition
3. `Shift+F12` or `Alt+R` - See all usages
4. `Alt+,` - Jump back

**Fixing errors:**
1. `F8` or `Alt+E` - See all errors
2. Navigate to error line
3. `F10` or `Alt+.` - Apply quick fix
4. `Ctrl+S` - Save

**Refactoring:**
1. `Shift+F12` or `Alt+R` - See all references
2. `F2` - Rename everywhere
3. `Shift+Alt+F` - Format code
4. `Ctrl+S` - Save

**Working with multiple files:**
1. `Ctrl+B` or `F3` - Browse file tree
2. `Enter` - Open in new tab
3. `Ctrl+PageDown/Up` - Switch between tabs
4. `Alt+V` / `Alt+S` - Split panes vertical/horizontal
5. `Alt+H/J/K/L` - Navigate panes

---

For detailed feature explanations, see [LSP_GUIDE.md](LSP_GUIDE.md)