GitHub - zackbart/seer: A fast, minimal TUI file browser with live previews

A fast, minimal TUI file browser with live previews - inspired by Yazi.

Two panes: directory listing on the left, instant file preview on the right. That's it.

Features

Two-pane layout with live file preview
Syntax-highlighted code previews (Shiki, nord theme)
Styled Markdown and HTML rendering with ANSI-aware word wrapping
Preview header shows size · lines · ~tokens · modified at a glance
Native Mermaid diagram preview (sequence, flowchart)
JSON pretty-printing with color
CSV/TSV table formatting
Office document previews: .docx, .xlsx, and .pdf (text extraction + table rendering)
Directory summaries and binary hex dump
Archive content listing (zip, tar, gz, etc.)
Fast fuzzy search (/ to filter)
Mouse support — scroll targets the pane under cursor, click-drag in preview to copy text
9 built-in color themes (7 dark, 2 light) with persistence
Nerd Font icons (with plain Unicode fallback)
Git status badges
Bounded async preview pipeline with LRU cache, tuned to keep navigation responsive on large files

Install

Homebrew

brew install zackbart/tap/seer

From source

Requires Bun.

git clone https://github.com/zackbart/seer.git
cd seer
bun install
bun run build
# ./seer is now a standalone binary

Usage

seer # Browse current directory
seer /some/path # Browse a specific directory
seer --version # Print version
seer --help # Show help

Shell cd integration

Add to ~/.bashrc or ~/.zshrc so quitting seer drops you into the last directory you browsed:

functions() {
local tmp=$(mktemp)command seer --cwd-file="$tmp""$@"local dir=$(cat "$tmp"2>/dev/null)
rm -f "$tmp"
[[ -n"$dir"&&-d"$dir" ]] &&cd"$dir"
}

Controls

Key	Action
`j` / `k`	Move up / down
`enter` / `l`	Enter directory
`h`	Parent directory
`g` / `G`	Jump to top / bottom
`/`	Fuzzy search
`.`	Toggle hidden files
`s`	Cycle sort mode
`t`	Cycle color theme
`p`	Copy file path to clipboard
`o`	Open selected item with the default app
`e`	Edit file in `nano` in a new terminal tab
`<` / `>`	Resize panes
`R`	Reload directory
`backspace`	Move to trash (with confirmation)
`q` / `ctrl+c`	Quit

Mouse: scroll to navigate either pane, click-drag in preview to select and copy text.

Themes

Press t to cycle through themes. Your choice is saved to ~/.config/seer/theme.

Tokyo Night (default)
Catppuccin Mocha
Rosé Pine
Gruvbox
Nord
Dracula
One Dark
GitHub Light
Solarized Light

Environment Variables

Variable	Effect
`SEER_NO_NERD_FONT=1`	Use plain Unicode instead of Nerd Font glyphs
`SEER_FAST_MODE=1`	Low-power mode: disables syntax highlighting, markdown/HTML rendering, and office/PDF parsers; shrinks the preview byte cap; raises the nav debounce. Use on Raspberry Pi, older laptops, or slow SSH connections. A `[fast]` badge appears in the status line while enabled.
`SEER_DEBUG_PERF=1`	Write JSON-lines perf events to `$TMPDIR/seer-perf.log` (`SEER_DEBUG_PERF_FILE=/path` overrides the destination).

Supported Formats

Code: Go, JS/TS, Python, Rust, C/C++, Ruby, Java, and many more (via Shiki)
Markup: Markdown, MDX, RST, HTML (rendered via turndown → marked-terminal)
Data: JSON, YAML, TOML, CSV, TSV, INI, ENV
Office: Word (.docx), Excel (.xlsx), PDF — text extraction with table rendering for spreadsheets
Diagrams: Mermaid (.mmd)
Archives: zip, tar, gz, bz2, xz, 7z, rar
Directories: file count, item listing
Binary: hex dump with offset

License

MIT

A fast, minimal TUI file browser with live previews - inspired by Yazi.

Two panes: directory listing on the left, instant file preview on the right. That's it.

Features

Two-pane layout with live file preview
Syntax-highlighted code previews (Shiki, nord theme)
Styled Markdown and HTML rendering with ANSI-aware word wrapping
Preview header shows size · lines · ~tokens · modified at a glance
Native Mermaid diagram preview (sequence, flowchart)
JSON pretty-printing with color
CSV/TSV table formatting
Office document previews: .docx, .xlsx, and .pdf (text extraction + table rendering)
Directory summaries and binary hex dump
Archive content listing (zip, tar, gz, etc.)
Fast fuzzy search (/ to filter)
Mouse support — scroll targets the pane under cursor, click-drag in preview to copy text
9 built-in color themes (7 dark, 2 light) with persistence
Nerd Font icons (with plain Unicode fallback)
Git status badges
Bounded async preview pipeline with LRU cache, tuned to keep navigation responsive on large files

Install

Homebrew

brew install zackbart/tap/seer

From source

Requires Bun.

git clone https://github.com/zackbart/seer.git
cd seer
bun install
bun run build
# ./seer is now a standalone binary

Usage

seer # Browse current directory
seer /some/path # Browse a specific directory
seer --version # Print version
seer --help # Show help

Shell cd integration

Add to ~/.bashrc or ~/.zshrc so quitting seer drops you into the last directory you browsed:

functions() {
local tmp=$(mktemp)command seer --cwd-file="$tmp""$@"local dir=$(cat "$tmp"2>/dev/null)
rm -f "$tmp"
[[ -n"$dir"&&-d"$dir" ]] &&cd"$dir"
}

Controls

Key	Action
`j` / `k`	Move up / down
`enter` / `l`	Enter directory
`h`	Parent directory
`g` / `G`	Jump to top / bottom
`/`	Fuzzy search
`.`	Toggle hidden files
`s`	Cycle sort mode
`t`	Cycle color theme
`p`	Copy file path to clipboard
`o`	Open selected item with the default app
`e`	Edit file in `nano` in a new terminal tab
`<` / `>`	Resize panes
`R`	Reload directory
`backspace`	Move to trash (with confirmation)
`q` / `ctrl+c`	Quit

Mouse: scroll to navigate either pane, click-drag in preview to select and copy text.

Themes

Press t to cycle through themes. Your choice is saved to ~/.config/seer/theme.

Tokyo Night (default)
Catppuccin Mocha
Rosé Pine
Gruvbox
Nord
Dracula
One Dark
GitHub Light
Solarized Light

Environment Variables

Variable	Effect
`SEER_NO_NERD_FONT=1`	Use plain Unicode instead of Nerd Font glyphs
`SEER_FAST_MODE=1`	Low-power mode: disables syntax highlighting, markdown/HTML rendering, and office/PDF parsers; shrinks the preview byte cap; raises the nav debounce. Use on Raspberry Pi, older laptops, or slow SSH connections. A `[fast]` badge appears in the status line while enabled.
`SEER_DEBUG_PERF=1`	Write JSON-lines perf events to `$TMPDIR/seer-perf.log` (`SEER_DEBUG_PERF_FILE=/path` overrides the destination).

Supported Formats

Code: Go, JS/TS, Python, Rust, C/C++, Ruby, Java, and many more (via Shiki)
Markup: Markdown, MDX, RST, HTML (rendered via turndown → marked-terminal)
Data: JSON, YAML, TOML, CSV, TSV, INI, ENV
Office: Word (.docx), Excel (.xlsx), PDF — text extraction with table rendering for spreadsheets
Diagrams: Mermaid (.mmd)
Archives: zip, tar, gz, bz2, xz, 7z, rar
Directories: file count, item listing
Binary: hex dump with offset

License

MIT

A fast, minimal TUI file browser with live previews - inspired by Yazi.

Two panes: directory listing on the left, instant file preview on the right. That's it.

Features

Two-pane layout with live file preview
Syntax-highlighted code previews (Shiki, nord theme)
Styled Markdown and HTML rendering with ANSI-aware word wrapping
Preview header shows size · lines · ~tokens · modified at a glance
Native Mermaid diagram preview (sequence, flowchart)
JSON pretty-printing with color
CSV/TSV table formatting
Office document previews: .docx, .xlsx, and .pdf (text extraction + table rendering)
Directory summaries and binary hex dump
Archive content listing (zip, tar, gz, etc.)
Fast fuzzy search (/ to filter)
Mouse support — scroll targets the pane under cursor, click-drag in preview to copy text
9 built-in color themes (7 dark, 2 light) with persistence
Nerd Font icons (with plain Unicode fallback)
Git status badges
Bounded async preview pipeline with LRU cache, tuned to keep navigation responsive on large files

Install

Homebrew

brew install zackbart/tap/seer

From source

Requires Bun.

git clone https://github.com/zackbart/seer.git
cd seer
bun install
bun run build
# ./seer is now a standalone binary

Usage

seer # Browse current directory
seer /some/path # Browse a specific directory
seer --version # Print version
seer --help # Show help

Shell cd integration

Add to ~/.bashrc or ~/.zshrc so quitting seer drops you into the last directory you browsed:

functions() {
local tmp=$(mktemp)command seer --cwd-file="$tmp""$@"local dir=$(cat "$tmp"2>/dev/null)
rm -f "$tmp"
[[ -n"$dir"&&-d"$dir" ]] &&cd"$dir"
}

Controls

Key	Action
`j` / `k`	Move up / down
`enter` / `l`	Enter directory
`h`	Parent directory
`g` / `G`	Jump to top / bottom
`/`	Fuzzy search
`.`	Toggle hidden files
`s`	Cycle sort mode
`t`	Cycle color theme
`p`	Copy file path to clipboard
`o`	Open selected item with the default app
`e`	Edit file in `nano` in a new terminal tab
`<` / `>`	Resize panes
`R`	Reload directory
`backspace`	Move to trash (with confirmation)
`q` / `ctrl+c`	Quit

Mouse: scroll to navigate either pane, click-drag in preview to select and copy text.

Themes

Press t to cycle through themes. Your choice is saved to ~/.config/seer/theme.

Tokyo Night (default)
Catppuccin Mocha
Rosé Pine
Gruvbox
Nord
Dracula
One Dark
GitHub Light
Solarized Light

Environment Variables

Variable	Effect
`SEER_NO_NERD_FONT=1`	Use plain Unicode instead of Nerd Font glyphs
`SEER_FAST_MODE=1`	Low-power mode: disables syntax highlighting, markdown/HTML rendering, and office/PDF parsers; shrinks the preview byte cap; raises the nav debounce. Use on Raspberry Pi, older laptops, or slow SSH connections. A `[fast]` badge appears in the status line while enabled.
`SEER_DEBUG_PERF=1`	Write JSON-lines perf events to `$TMPDIR/seer-perf.log` (`SEER_DEBUG_PERF_FILE=/path` overrides the destination).

Supported Formats

Code: Go, JS/TS, Python, Rust, C/C++, Ruby, Java, and many more (via Shiki)
Markup: Markdown, MDX, RST, HTML (rendered via turndown → marked-terminal)
Data: JSON, YAML, TOML, CSV, TSV, INI, ENV
Office: Word (.docx), Excel (.xlsx), PDF — text extraction with table rendering for spreadsheets
Diagrams: Mermaid (.mmd)
Archives: zip, tar, gz, bz2, xz, 7z, rar
Directories: file count, item listing
Binary: hex dump with offset

License

MIT

A fast, minimal TUI file browser with live previews - inspired by Yazi.

Two panes: directory listing on the left, instant file preview on the right. That's it.

Features

Two-pane layout with live file preview
Syntax-highlighted code previews (Shiki, nord theme)
Styled Markdown and HTML rendering with ANSI-aware word wrapping
Preview header shows size · lines · ~tokens · modified at a glance
Native Mermaid diagram preview (sequence, flowchart)
JSON pretty-printing with color
CSV/TSV table formatting
Office document previews: .docx, .xlsx, and .pdf (text extraction + table rendering)
Directory summaries and binary hex dump
Archive content listing (zip, tar, gz, etc.)
Fast fuzzy search (/ to filter)
Mouse support — scroll targets the pane under cursor, click-drag in preview to copy text
9 built-in color themes (7 dark, 2 light) with persistence
Nerd Font icons (with plain Unicode fallback)
Git status badges
Bounded async preview pipeline with LRU cache, tuned to keep navigation responsive on large files

Install

Homebrew

brew install zackbart/tap/seer

From source

Requires Bun.

git clone https://github.com/zackbart/seer.git
cd seer
bun install
bun run build
# ./seer is now a standalone binary

Usage

seer # Browse current directory
seer /some/path # Browse a specific directory
seer --version # Print version
seer --help # Show help

Shell cd integration

Add to ~/.bashrc or ~/.zshrc so quitting seer drops you into the last directory you browsed:

functions() {
local tmp=$(mktemp)command seer --cwd-file="$tmp""$@"local dir=$(cat "$tmp"2>/dev/null)
rm -f "$tmp"
[[ -n"$dir"&&-d"$dir" ]] &&cd"$dir"
}

Controls

Key	Action
`j` / `k`	Move up / down
`enter` / `l`	Enter directory
`h`	Parent directory
`g` / `G`	Jump to top / bottom
`/`	Fuzzy search
`.`	Toggle hidden files
`s`	Cycle sort mode
`t`	Cycle color theme
`p`	Copy file path to clipboard
`o`	Open selected item with the default app
`e`	Edit file in `nano` in a new terminal tab
`<` / `>`	Resize panes
`R`	Reload directory
`backspace`	Move to trash (with confirmation)
`q` / `ctrl+c`	Quit

Mouse: scroll to navigate either pane, click-drag in preview to select and copy text.

Themes

Press t to cycle through themes. Your choice is saved to ~/.config/seer/theme.

Tokyo Night (default)
Catppuccin Mocha
Rosé Pine
Gruvbox
Nord
Dracula
One Dark
GitHub Light
Solarized Light

Environment Variables

Variable	Effect
`SEER_NO_NERD_FONT=1`	Use plain Unicode instead of Nerd Font glyphs
`SEER_FAST_MODE=1`	Low-power mode: disables syntax highlighting, markdown/HTML rendering, and office/PDF parsers; shrinks the preview byte cap; raises the nav debounce. Use on Raspberry Pi, older laptops, or slow SSH connections. A `[fast]` badge appears in the status line while enabled.
`SEER_DEBUG_PERF=1`	Write JSON-lines perf events to `$TMPDIR/seer-perf.log` (`SEER_DEBUG_PERF_FILE=/path` overrides the destination).

Supported Formats

Code: Go, JS/TS, Python, Rust, C/C++, Ruby, Java, and many more (via Shiki)
Markup: Markdown, MDX, RST, HTML (rendered via turndown → marked-terminal)
Data: JSON, YAML, TOML, CSV, TSV, INI, ENV
Office: Word (.docx), Excel (.xlsx), PDF — text extraction with table rendering for spreadsheets
Diagrams: Mermaid (.mmd)
Archives: zip, tar, gz, bz2, xz, 7z, rar
Directories: file count, item listing
Binary: hex dump with offset

License

MIT

A fast, minimal TUI file browser with live previews - inspired by Yazi.

Two panes: directory listing on the left, instant file preview on the right. That's it.

Features

Two-pane layout with live file preview
Syntax-highlighted code previews (Shiki, nord theme)
Styled Markdown and HTML rendering with ANSI-aware word wrapping
Preview header shows size · lines · ~tokens · modified at a glance
Native Mermaid diagram preview (sequence, flowchart)
JSON pretty-printing with color
CSV/TSV table formatting
Office document previews: .docx, .xlsx, and .pdf (text extraction + table rendering)
Directory summaries and binary hex dump
Archive content listing (zip, tar, gz, etc.)
Fast fuzzy search (/ to filter)
Mouse support — scroll targets the pane under cursor, click-drag in preview to copy text
9 built-in color themes (7 dark, 2 light) with persistence
Nerd Font icons (with plain Unicode fallback)
Git status badges
Bounded async preview pipeline with LRU cache, tuned to keep navigation responsive on large files

Install

Homebrew

brew install zackbart/tap/seer

From source

Requires Bun.

git clone https://github.com/zackbart/seer.git
cd seer
bun install
bun run build
# ./seer is now a standalone binary

Usage

seer # Browse current directory
seer /some/path # Browse a specific directory
seer --version # Print version
seer --help # Show help

Shell cd integration

Add to ~/.bashrc or ~/.zshrc so quitting seer drops you into the last directory you browsed:

functions() {
local tmp=$(mktemp)command seer --cwd-file="$tmp""$@"local dir=$(cat "$tmp"2>/dev/null)
rm -f "$tmp"
[[ -n"$dir"&&-d"$dir" ]] &&cd"$dir"
}

Controls

Key	Action
`j` / `k`	Move up / down
`enter` / `l`	Enter directory
`h`	Parent directory
`g` / `G`	Jump to top / bottom
`/`	Fuzzy search
`.`	Toggle hidden files
`s`	Cycle sort mode
`t`	Cycle color theme
`p`	Copy file path to clipboard
`o`	Open selected item with the default app
`e`	Edit file in `nano` in a new terminal tab
`<` / `>`	Resize panes
`R`	Reload directory
`backspace`	Move to trash (with confirmation)
`q` / `ctrl+c`	Quit

Mouse: scroll to navigate either pane, click-drag in preview to select and copy text.

Themes

Press t to cycle through themes. Your choice is saved to ~/.config/seer/theme.

Tokyo Night (default)
Catppuccin Mocha
Rosé Pine
Gruvbox
Nord
Dracula
One Dark
GitHub Light
Solarized Light

Environment Variables

Variable	Effect
`SEER_NO_NERD_FONT=1`	Use plain Unicode instead of Nerd Font glyphs
`SEER_FAST_MODE=1`	Low-power mode: disables syntax highlighting, markdown/HTML rendering, and office/PDF parsers; shrinks the preview byte cap; raises the nav debounce. Use on Raspberry Pi, older laptops, or slow SSH connections. A `[fast]` badge appears in the status line while enabled.
`SEER_DEBUG_PERF=1`	Write JSON-lines perf events to `$TMPDIR/seer-perf.log` (`SEER_DEBUG_PERF_FILE=/path` overrides the destination).

Supported Formats

Code: Go, JS/TS, Python, Rust, C/C++, Ruby, Java, and many more (via Shiki)
Markup: Markdown, MDX, RST, HTML (rendered via turndown → marked-terminal)
Data: JSON, YAML, TOML, CSV, TSV, INI, ENV
Office: Word (.docx), Excel (.xlsx), PDF — text extraction with table rendering for spreadsheets
Diagrams: Mermaid (.mmd)
Archives: zip, tar, gz, bz2, xz, 7z, rar
Directories: file count, item listing
Binary: hex dump with offset

License

MIT

A fast, minimal TUI file browser with live previews - inspired by Yazi.

Two panes: directory listing on the left, instant file preview on the right. That's it.

Features

Two-pane layout with live file preview
Syntax-highlighted code previews (Shiki, nord theme)
Styled Markdown and HTML rendering with ANSI-aware word wrapping
Preview header shows size · lines · ~tokens · modified at a glance
Native Mermaid diagram preview (sequence, flowchart)
JSON pretty-printing with color
CSV/TSV table formatting
Office document previews: .docx, .xlsx, and .pdf (text extraction + table rendering)
Directory summaries and binary hex dump
Archive content listing (zip, tar, gz, etc.)
Fast fuzzy search (/ to filter)
Mouse support — scroll targets the pane under cursor, click-drag in preview to copy text
9 built-in color themes (7 dark, 2 light) with persistence
Nerd Font icons (with plain Unicode fallback)
Git status badges
Bounded async preview pipeline with LRU cache, tuned to keep navigation responsive on large files

Install

Homebrew

brew install zackbart/tap/seer

From source

Requires Bun.

git clone https://github.com/zackbart/seer.git
cd seer
bun install
bun run build
# ./seer is now a standalone binary

Usage

seer # Browse current directory
seer /some/path # Browse a specific directory
seer --version # Print version
seer --help # Show help

Shell cd integration

Add to ~/.bashrc or ~/.zshrc so quitting seer drops you into the last directory you browsed:

functions() {
local tmp=$(mktemp)command seer --cwd-file="$tmp""$@"local dir=$(cat "$tmp"2>/dev/null)
rm -f "$tmp"
[[ -n"$dir"&&-d"$dir" ]] &&cd"$dir"
}

Controls

Key	Action
`j` / `k`	Move up / down
`enter` / `l`	Enter directory
`h`	Parent directory
`g` / `G`	Jump to top / bottom
`/`	Fuzzy search
`.`	Toggle hidden files
`s`	Cycle sort mode
`t`	Cycle color theme
`p`	Copy file path to clipboard
`o`	Open selected item with the default app
`e`	Edit file in `nano` in a new terminal tab
`<` / `>`	Resize panes
`R`	Reload directory
`backspace`	Move to trash (with confirmation)
`q` / `ctrl+c`	Quit

Mouse: scroll to navigate either pane, click-drag in preview to select and copy text.

Themes

Press t to cycle through themes. Your choice is saved to ~/.config/seer/theme.

Tokyo Night (default)
Catppuccin Mocha
Rosé Pine
Gruvbox
Nord
Dracula
One Dark
GitHub Light
Solarized Light

Environment Variables

Variable	Effect
`SEER_NO_NERD_FONT=1`	Use plain Unicode instead of Nerd Font glyphs
`SEER_FAST_MODE=1`	Low-power mode: disables syntax highlighting, markdown/HTML rendering, and office/PDF parsers; shrinks the preview byte cap; raises the nav debounce. Use on Raspberry Pi, older laptops, or slow SSH connections. A `[fast]` badge appears in the status line while enabled.
`SEER_DEBUG_PERF=1`	Write JSON-lines perf events to `$TMPDIR/seer-perf.log` (`SEER_DEBUG_PERF_FILE=/path` overrides the destination).

Supported Formats

Code: Go, JS/TS, Python, Rust, C/C++, Ruby, Java, and many more (via Shiki)
Markup: Markdown, MDX, RST, HTML (rendered via turndown → marked-terminal)
Data: JSON, YAML, TOML, CSV, TSV, INI, ENV
Office: Word (.docx), Excel (.xlsx), PDF — text extraction with table rendering for spreadsheets
Diagrams: Mermaid (.mmd)
Archives: zip, tar, gz, bz2, xz, 7z, rar
Directories: file count, item listing
Binary: hex dump with offset

License

MIT

A fast, minimal TUI file browser with live previews - inspired by Yazi.

Two panes: directory listing on the left, instant file preview on the right. That's it.

Features

Two-pane layout with live file preview
Syntax-highlighted code previews (Shiki, nord theme)
Styled Markdown and HTML rendering with ANSI-aware word wrapping
Preview header shows size · lines · ~tokens · modified at a glance
Native Mermaid diagram preview (sequence, flowchart)
JSON pretty-printing with color
CSV/TSV table formatting
Office document previews: .docx, .xlsx, and .pdf (text extraction + table rendering)
Directory summaries and binary hex dump
Archive content listing (zip, tar, gz, etc.)
Fast fuzzy search (/ to filter)
Mouse support — scroll targets the pane under cursor, click-drag in preview to copy text
9 built-in color themes (7 dark, 2 light) with persistence
Nerd Font icons (with plain Unicode fallback)
Git status badges
Bounded async preview pipeline with LRU cache, tuned to keep navigation responsive on large files

Install

Homebrew

brew install zackbart/tap/seer

From source

Requires Bun.

git clone https://github.com/zackbart/seer.git
cd seer
bun install
bun run build
# ./seer is now a standalone binary

Usage

seer # Browse current directory
seer /some/path # Browse a specific directory
seer --version # Print version
seer --help # Show help

Shell cd integration

Add to ~/.bashrc or ~/.zshrc so quitting seer drops you into the last directory you browsed:

functions() {
local tmp=$(mktemp)command seer --cwd-file="$tmp""$@"local dir=$(cat "$tmp"2>/dev/null)
rm -f "$tmp"
[[ -n"$dir"&&-d"$dir" ]] &&cd"$dir"
}

Controls

Key	Action
`j` / `k`	Move up / down
`enter` / `l`	Enter directory
`h`	Parent directory
`g` / `G`	Jump to top / bottom
`/`	Fuzzy search
`.`	Toggle hidden files
`s`	Cycle sort mode
`t`	Cycle color theme
`p`	Copy file path to clipboard
`o`	Open selected item with the default app
`e`	Edit file in `nano` in a new terminal tab
`<` / `>`	Resize panes
`R`	Reload directory
`backspace`	Move to trash (with confirmation)
`q` / `ctrl+c`	Quit

Mouse: scroll to navigate either pane, click-drag in preview to select and copy text.

Themes

Press t to cycle through themes. Your choice is saved to ~/.config/seer/theme.

Tokyo Night (default)
Catppuccin Mocha
Rosé Pine
Gruvbox
Nord
Dracula
One Dark
GitHub Light
Solarized Light

Environment Variables

Variable	Effect
`SEER_NO_NERD_FONT=1`	Use plain Unicode instead of Nerd Font glyphs
`SEER_FAST_MODE=1`	Low-power mode: disables syntax highlighting, markdown/HTML rendering, and office/PDF parsers; shrinks the preview byte cap; raises the nav debounce. Use on Raspberry Pi, older laptops, or slow SSH connections. A `[fast]` badge appears in the status line while enabled.
`SEER_DEBUG_PERF=1`	Write JSON-lines perf events to `$TMPDIR/seer-perf.log` (`SEER_DEBUG_PERF_FILE=/path` overrides the destination).

Supported Formats

Code: Go, JS/TS, Python, Rust, C/C++, Ruby, Java, and many more (via Shiki)
Markup: Markdown, MDX, RST, HTML (rendered via turndown → marked-terminal)
Data: JSON, YAML, TOML, CSV, TSV, INI, ENV
Office: Word (.docx), Excel (.xlsx), PDF — text extraction with table rendering for spreadsheets
Diagrams: Mermaid (.mmd)
Archives: zip, tar, gz, bz2, xz, 7z, rar
Directories: file count, item listing
Binary: hex dump with offset

License

MIT

A fast, minimal TUI file browser with live previews - inspired by Yazi.

Two panes: directory listing on the left, instant file preview on the right. That's it.

Features

Two-pane layout with live file preview
Syntax-highlighted code previews (Shiki, nord theme)
Styled Markdown and HTML rendering with ANSI-aware word wrapping
Preview header shows size · lines · ~tokens · modified at a glance
Native Mermaid diagram preview (sequence, flowchart)
JSON pretty-printing with color
CSV/TSV table formatting
Office document previews: .docx, .xlsx, and .pdf (text extraction + table rendering)
Directory summaries and binary hex dump
Archive content listing (zip, tar, gz, etc.)
Fast fuzzy search (/ to filter)
Mouse support — scroll targets the pane under cursor, click-drag in preview to copy text
9 built-in color themes (7 dark, 2 light) with persistence
Nerd Font icons (with plain Unicode fallback)
Git status badges
Bounded async preview pipeline with LRU cache, tuned to keep navigation responsive on large files

Install

Homebrew

brew install zackbart/tap/seer

From source

Requires Bun.

git clone https://github.com/zackbart/seer.git
cd seer
bun install
bun run build
# ./seer is now a standalone binary

Usage

seer # Browse current directory
seer /some/path # Browse a specific directory
seer --version # Print version
seer --help # Show help

Shell cd integration

Add to ~/.bashrc or ~/.zshrc so quitting seer drops you into the last directory you browsed:

functions() {
local tmp=$(mktemp)command seer --cwd-file="$tmp""$@"local dir=$(cat "$tmp"2>/dev/null)
rm -f "$tmp"
[[ -n"$dir"&&-d"$dir" ]] &&cd"$dir"
}

Controls

Key	Action
`j` / `k`	Move up / down
`enter` / `l`	Enter directory
`h`	Parent directory
`g` / `G`	Jump to top / bottom
`/`	Fuzzy search
`.`	Toggle hidden files
`s`	Cycle sort mode
`t`	Cycle color theme
`p`	Copy file path to clipboard
`o`	Open selected item with the default app
`e`	Edit file in `nano` in a new terminal tab
`<` / `>`	Resize panes
`R`	Reload directory
`backspace`	Move to trash (with confirmation)
`q` / `ctrl+c`	Quit

Mouse: scroll to navigate either pane, click-drag in preview to select and copy text.

Themes

Press t to cycle through themes. Your choice is saved to ~/.config/seer/theme.

Tokyo Night (default)
Catppuccin Mocha
Rosé Pine
Gruvbox
Nord
Dracula
One Dark
GitHub Light
Solarized Light

Environment Variables

Variable	Effect
`SEER_NO_NERD_FONT=1`	Use plain Unicode instead of Nerd Font glyphs
`SEER_FAST_MODE=1`	Low-power mode: disables syntax highlighting, markdown/HTML rendering, and office/PDF parsers; shrinks the preview byte cap; raises the nav debounce. Use on Raspberry Pi, older laptops, or slow SSH connections. A `[fast]` badge appears in the status line while enabled.
`SEER_DEBUG_PERF=1`	Write JSON-lines perf events to `$TMPDIR/seer-perf.log` (`SEER_DEBUG_PERF_FILE=/path` overrides the destination).

Supported Formats

Code: Go, JS/TS, Python, Rust, C/C++, Ruby, Java, and many more (via Shiki)
Markup: Markdown, MDX, RST, HTML (rendered via turndown → marked-terminal)
Data: JSON, YAML, TOML, CSV, TSV, INI, ENV
Office: Word (.docx), Excel (.xlsx), PDF — text extraction with table rendering for spreadsheets
Diagrams: Mermaid (.mmd)
Archives: zip, tar, gz, bz2, xz, 7z, rar
Directories: file count, item listing
Binary: hex dump with offset

License

MIT

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.gocache		.gocache
assets		assets
scripts		scripts
src		src
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
README.md		README.md
bun.lock		bun.lock
package.json		package.json
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.gocache		.gocache
assets		assets
scripts		scripts
src		src
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
README.md		README.md
bun.lock		bun.lock
package.json		package.json
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.gocache		.gocache
assets		assets
scripts		scripts
src		src
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
README.md		README.md
bun.lock		bun.lock
package.json		package.json
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.gocache		.gocache
assets		assets
scripts		scripts
src		src
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
README.md		README.md
bun.lock		bun.lock
package.json		package.json
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.gocache		.gocache
assets		assets
scripts		scripts
src		src
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
README.md		README.md
bun.lock		bun.lock
package.json		package.json
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation

Features

Install

Homebrew

From source

Usage

Shell cd integration

Controls

Themes

Environment Variables

Supported Formats

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Features

Install

Homebrew

From source

Usage

Shell cd integration

Controls

Themes

Environment Variables

Supported Formats

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Features

Install

Homebrew

From source

Usage

Shell cd integration

Controls

Themes

Environment Variables

Supported Formats

License

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Features

Install

Homebrew

From source