Single layer, like a desktop
No deep tree to scan. One folder per screen, click to dive in.
Why mira?
Mouse + keyboard
Arrow keys, wasd, or just click. Whatever your hands prefer.
Gitignore aware
Respects every .gitignore from repo root down to your cwd. Toggle off with --no-ignore.
Pipe-friendly fallback
Detects when stdout isn't a terminal and prints a clean flat list. Works great with grep, fzf, and friends.
Zero config
Single binary, no shell integration, no rc-file dance. Just put it on PATH.
Read-only by design
mira never writes, executes, or transmits. See SECURITY.md.
Install
Homebrew (macOS / Linux)
brew install mondial7/tap/mira
The tap is published automatically on every release, so brew upgrade mira always pulls the latest.
Go
go install github.com/mondial7/mira@latest
Pre-built binaries
Grab a tarball for your platform from the releases page. Each release ships SHA-256 checksums and an SBOM you can verify before extracting.
Quick reference
| Key | Action |
|---|---|
| ← → a d | Move cursor left/right |
| ↑ ↓ w s | Move cursor up/down |
| Enter / Space | Open selected folder |
| Backspace / Esc | Go up one directory |
| g / G | Jump to first / last item |
| h | Toggle hidden entries |
| f | Fuzzy-find within the current folder |
| . | Open the settings overlay (theme, borders, bionic) |
| e | "End here": quit and cd into the explored directory (with shell wrapper) |
| q / Ctrl-C | Quit |
| Mouse click | Move cursor and (on a folder) enter it |
Built with
- bubbletea — the Elm-architecture TUI framework
- lipgloss — styled string composition
- go-gitignore — gitignore matcher