Install gamr

Requirements

• Python 3.11 or later
• uv (for uvx) or pip

Quick Start

# Run directly with uvx (no install needed)
uvx gamr

With pip

pip install gamr
gamr ~/project

Usage

# Monitor current directory
uvx gamr

# Monitor a specific project
uvx gamr ~/path/to/project

# Works on non-git directories too
uvx gamr /tmp/scratch

Configuration

gamr stores preferences in ~/.config/gamr/preferences.toml. Session state (collapsed directories, column widths, etc.) is saved automatically between sessions.

File icons are loaded from ~/.config/lsd/icons.yaml if present.