peektea

A minimal terminal file browser built with Bubble Tea.

Peek through your filesystem with arrow keys (or vim keys), then pour each file straight into the app you've configured for it.

A quick peek before you steep

Why peektea

• Keyboard-first — arrow keys or vim keybindings (hjkl), no mouse required
• Smart previews — text with syntax highlighting via bat, images via chafa, directory listings, and binary detection
• Real-time filtering — narrow the list as you type, toggle hidden files on demand
• Configurable openers — route every file extension to the program of your choice
• WSL aware — automatically routes file opens through wslview or explorer.exe with path conversion

Get started

• Install

  ---

  One-liner script, prebuilt binaries, go install, or build from source.

  Installation

• Learn the keys

  ---

  Navigate, filter, preview, and sort — all from the keyboard.

  Usage

• Configure openers

  ---

  Run peektea init and tell peektea which app opens which file type.

  Configuration

• Using WSL?

  ---

  peektea detects WSL automatically and opens files in your Windows apps.

  WSL support

Stack

peektea is built on the Charm stack:

• Bubble Tea — TUI framework (Elm Architecture)
• Bubbles — TUI components (textinput for filtering)
• Lipgloss — terminal styling

Source

peektea is open source on GitHub. Issues, stars, and contributions are welcome.