Documentation

features

File Preview

croot's split-pane preview lets you read files without leaving the file tree.

Toggle Preview

Press p to toggle the preview pane. The file under the cursor is previewed automatically.

Syntax Highlighting

The preview uses ANSI-native syntax highlighting, so code colors follow your terminal's theme instead of a fixed RGB palette. The built-in highlighter currently supports Rust, JavaScript, TypeScript/TSX, JSON, and raw Markdown.

Markdown Rendering

Markdown files are rendered with formatting by default. Press m to toggle between rendered and raw Markdown view.

Binary Files

Binary files are displayed as hex dumps with both hex values and ASCII representation.

Configuration

[preview]
auto_preview = false      # Open preview automatically on start
preview_delay_ms = 150    # Debounce delay before preview updates
show_line_numbers = true  # Show line numbers
max_file_size_kb = 1024   # Skip files larger than this (KB)
split_ratio = 0.5         # Width ratio (0.0 = all tree, 1.0 = all preview)
render_markdown = true    # Render Markdown by default

[syntax]
enabled = true

[syntax.tokens.keyword]
fg = "magenta"
bold = true

[syntax.tokens.type]
fg = "cyan"

preview.syntax_highlight is still accepted as a legacy fallback, but new syntax color customization lives under [syntax].

Resizing

Drag the divider between the tree and preview to resize. The split_ratio config sets the default.

Directory Preview

When a directory is selected, the preview shows a listing of its contents with file counts.