A quick guide to getting the most out of the tool.
gamr has two panes: a file tree on the left and a preview on the right. Press tab to move focus between them. Between the panes is a draggable splitter — grab it with the mouse to resize. Your split position is remembered between sessions.
Move between files with ↑/↓ or j/k. Open directories with → or space, close them with ← or space. Press ← on a file to jump to its parent directory.
Fuzzy filename search powered by RapidFuzz. Start typing and the tree filters instantly. Works across all view modes. Press Esc to clear and return to the full tree.
Cycle between three ways to see your files:
TUI Status Bar: 🌳 tree → 📄 flat → 📁 path. Click to cycle.
Keys 1–7 toggle individual columns on and off: status, lines, size, rows, mtime, author, and git time.
Toggle to show only files with git changes — modified, added, deleted, or untracked. Everything unchanged disappears. One keypress to cut through the noise of a large repo.
TUI Status Bar: 🔸 git (N/M) when active, showing matching file count. Click to toggle.
When the preview pane is focused, ↑/↓ and j/k scroll line by line. space pages down. Page Up and Page Down also work.
J or n jumps to the next diff hunk — even if it's offscreen. K or N jumps to the previous one. This lets you quickly step through all changes in a file without manually scrolling.
Cycle between three inline diff styles:
git diff.TUI Status Bar: full 👓 → gutter 👓 → unified 👓. Click to cycle.
Opens a modal showing the old and new versions of the file aligned side by side. Character-level change highlighting makes it easy to spot exactly what was modified. Press s again or Esc to close.
Cycles the diff overview bar on the right edge of the preview — a minimap showing where changes are in the file. Five modes: off, line (1×), quadrant (2×), sextant (3×), and braille (4×).
TUI Status Bar: overview 1x → overview 2x → overview 3x → overview ⣿ → overview ·. Click to cycle.
When enabled, gamr automatically selects whichever file was last modified. As your agent writes code, you see it happen in real-time.
Combine with g (git filter) for a focused live view of exactly what's changing.
TUI Status Bar: follow 👀 when active. Click to toggle.
e opens the selected file in your terminal editor — it checks $VISUAL first, then $EDITOR. O opens it in your OS default application (your GUI markdown editor, image viewer, etc).
Select lines in the preview and the file reference is copied to your clipboard as src/app.py:81-85. Paste it straight into your agent's chat to ask about specific code.
Preferences live in ~/.config/gamr/preferences.toml. Session state — collapsed directories, scroll position, column widths, active filters — is saved automatically between runs.
File icons load from ~/.config/lsd/icons.yaml if present (same format as lsd).
gamr is built with Textual and Dulwich (pure Python git). No compiled dependencies, no git binary required.