Editor Preview - Quick Reference

# Editor Preview - Quick Reference

## Opening the Editor Preview
1. In chat, type: `/edit <filename>`
2. Neovim opens automatically in Windows Terminal
3. Press `Alt+5` to switch to the Editor Preview window

## Navigation Controls

### Line-by-Line Scrolling
- `j` or `↓` - Scroll down one line
- `k` or `↑` - Scroll up one line

### Page Scrolling
- `Ctrl+D` - Scroll down half page (Vim-style)
- `Ctrl+U` - Scroll up half page (Vim-style)
- `PgDn` - Scroll down full page
- `PgUp` - Scroll up full page

### Jump Navigation
- `Home` or `g` - Jump to top of file
- `End` or `Shift+G` - Jump to bottom of file

### Quick Actions
- `Alt+N` - Open file in Neovim (if not already open)
- `R` or `F5` - Force refresh/reload from disk
- `?` - Show help message

## Status Bar Information
```
🔍 PREVIEW MODE | 📄 main.go | 450 lines | Line 123/450 (27%) | Alt+N: Open Neovim
```

- **Preview Mode**: Indicates read-only preview (editing happens in Neovim)
- **Filename**: Current file being previewed
- **Line Count**: Total lines in file
- **Position**: Current line / Total lines (Scroll percentage)
- **Quick Hint**: Reminder to use Alt+N for editing

## Workflow Tips

### Real-Time Editing
1. Open file with `/edit filename.go`
2. Switch to Neovim window (opens automatically)
3. Make edits in Neovim
4. Save with `:w` (or `:wq`)
5. Switch to TUI with `Alt+6`
6. See changes appear within 500ms automatically

### Reviewing Long Files
- Use `j`/`k` for careful line-by-line review
- Use `Ctrl+D`/`Ctrl+U` for quick scanning
- Use `PgDn`/`PgUp` for section-by-section navigation
- Use `Home`/`End` to check file boundaries
- Watch scroll percentage to track progress

### Multi-User Collaboration
- See colored cursors for other users
- User list shown at top: `👥 Editing: alice, bob`
- Each user gets unique cursor color
- Cursors update in real-time

## Performance Notes
- File changes detected efficiently (checks modification time, not full content)
- Updates only when file actually changes
- Typical latency: <500ms from Neovim save to preview update
- Works well with files up to several thousand lines

## Troubleshooting

### Preview Not Updating?
- Press `R` or `F5` to force refresh
- Check if file is actually saved in Neovim (`:w`)
- Verify file path is correct

### Can't See Full File?
- Use scroll keys (`j`/`k`, `PgDn`/`PgUp`)
- Check scroll position in status bar
- Press `End` or `Shift+G` to jump to bottom

### Neovim Won't Open?
- Check if Neovim is installed
- Verify `nvim` is in PATH
- Try opening manually: `nvim <filename>`

## Window Switching
- `Alt+1` - Chat
- `Alt+2` - Projects  
- `Alt+3` - Tasks
- `Alt+4` - Logs (where editor command outputs go)
- `Alt+5` - Review
- `Alt+6` - **Editor Preview** (this window)
- `Alt+7` - Notes

## Related Commands
- `/edit <file>` - Open file in Neovim + show preview
- `/review start <branch>` - Start code review
- `/snippet save <name>` - Save current code snippet

## Design Philosophy
The Editor Preview is **not** for editing - it's a real-time window into what's happening in Neovim. Think of it as:
- 📺 A live video feed of your file
- 🔍 A preview pane while editing elsewhere
- 👥 A collaboration monitor showing others' cursors
- 📊 A reference window while coding

**For editing**: Use Neovim (Alt+N to open)
**For viewing**: Use Editor Preview (Alt+6)

---

**Pro Tip**: Keep Neovim and TUI side-by-side on different monitors or in split terminals for the ultimate coding experience!