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!