servef

Browse any file in a local directory: rendered Markdown, image previews, formatted JSON/YAML/HTML/CSS/JavaScript, and highlighted source for everything else.

Features

• Rendered Markdown, image previews, and highlighted, read-only source
• Format JSON, YAML, HTML, CSS, and JavaScript on demand; files stay unchanged
• Serve several directories; switch repositories and worktrees
• VS Code-style Explorer, Search, Source Control, tabs, and command palette
• Review uncommitted work, commits, a range of commits, or a branch stack layer by layer in one stacked diff tab
• Go to definition and find references through installed language servers
• 28 themes, including Omarchy's built-ins; Mermaid diagrams; line links

Install

Homebrew

brew install flexdinesh/tap/servef

Go

Requires Go 1.26 or later.

Latest stable release:

go install github.com/flexdinesh/servef@latest

Specific stable version:

go install github.com/flexdinesh/servef@v0.1.3

Latest main that passed CI:

go install github.com/flexdinesh/servef@edge

These installs include the embedded frontend; Node.js and pnpm are not required. Other branches and commits do not include it and fail to build with go install.

Usage

Serve the current directory:

servef .

See all options:

servef --help

Documentation

Usage, browsing, and code navigation guides live in site/src/pages. Contributors: see development and architecture.