traverse

The TUI file manager that treats Windows as a first-class citizen.

Why traverse?

Feature	traverse	superfile	lf	yazi
PowerShell integration	✅	❌	❌	❌
Instant filter	✅	✅	✅	✅
Git diff in preview	✅	✅	❌	✅
Single binary (Go)	✅	✅	✅	❌ (Rust)
Charm TUI stack	✅	✅	❌	❌

traverse is built for developers who live in the terminal on Windows. It doesn't just "work on Windows" — it's designed around Windows workflows: native PowerShell integration (Ctrl+Z to open a shell that auto-cds to your current directory), Git-aware file browsing with diff preview, and instant filtering for large directories.

Install

go install github.com/chenyc21/traverse@latest

Or download from GitHub Releases.

Scoop (Windows)

scoop install traverse

Scoop manifest available in scoop/traverse.json. See Scoop documentation for details.

Usage

# Open current directory
traverse

# Open specific directory
traverse /path/to/dir
traverse D:\projects

Keybindings

Navigation

Key	Action
k / ↑	Move up
j / ↓	Move down
h / ← / Backspace	Go to parent directory
l / → / Enter	Enter directory
g g	Jump to top (press g twice)
G	Jump to bottom
Ctrl+u	Page up
Ctrl+d	Page down

Filter

Key	Action
/	Enter instant filter mode
Esc	Exit filter, restore full list
Backspace	Remove last filter character

File Operations

Key	Action
y	Copy file
d	Cut file
p	Paste file
x	Delete file (with confirmation)
r	Rename file

Selection

Key	Action
Space	Select / deselect
a	Select all / deselect all

Git

Key	Action
s	Stage file
S	Unstage file
D	View diff in preview

View

Key	Action
Tab	Toggle preview panel
.	Toggle hidden files
K / J (uppercase)	Scroll preview (when open)

Shell

Key	Action
Ctrl+Z	Open PowerShell (auto-cd to current directory)

Other

Key	Action
?	Toggle help
q	Quit

Configuration

Configuration file location:

• Windows: %APPDATA%\traverse\config.yaml
• macOS: ~/Library/Application Support/traverse/config.yaml
• Linux: ~/.config/traverse/config.yaml

See config.example.yaml for all options.

Supported Languages (MVP)

Syntax highlighting is available for:

• Go
• Python
• JavaScript / TypeScript
• Rust
• C / C++
• Java
• Markdown

Other text files are displayed as plain text.

Building from Source

git clone https://github.com/chenyc21/traverse.git
cd traverse
go build -o traverse .

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT