FileView (fv)

Zero-config terminal file browser with image preview, built in Rust.

English | 日本語

Demo

I wanted a lightweight file manager like yazi that I could use day-to-day in the terminal and also connect to Claude Code — without spending time on config files.

Features

• Auto image preview (Kitty, iTerm2, Sixel, Halfblocks)
• 2.2ms startup, ~8MB memory (benchmarks)
• Git status, syntax highlighting, PDF preview, fuzzy finder
• Vim keybindings, mouse support, Lua plugins

Quick Start

cargo install fileview
fv

Install Options

Chafa image support: cargo install fileview --features chafa
Speed-optimized build: cargo install fileview --profile release-fast

Image Preview

Your terminal is auto-detected:

Terminal	Protocol
Kitty / Ghostty / Konsole	Kitty Graphics
iTerm2 / WezTerm / Warp	iTerm2 Inline
Foot / Windows Terminal	Sixel
VS Code / Alacritty	Halfblocks

Keybindings

Key	Action
j/k	Navigate up/down
h/l	Collapse/expand
g/G	Top/bottom
Space	Toggle mark
/	Search
Ctrl+P	Fuzzy finder
P	Preview panel
q	Quit

See docs/KEYBINDINGS.md for the full list.

Claude Code Integration

FileView includes an MCP server for Claude Code (fv --mcp-server).

{
  "mcpServers": {
    "fileview": {
      "command": "fv",
      "args": ["--mcp-server"]
    }
  }
}

Details: docs/CLAUDE_CODE.md

Docs

• Keybindings
• Claude Code / MCP
• Lua Plugins

License

MIT