herdr-file-viewer

(★ 457)

A git-aware, read-only file viewer for herdr. Mouse friendly, keyboard-driven TUI: tree + content pane with diffs, rendered markdown, and syntax highlighting.

File Explorer

Download Latest Version (.zip)

- - bug_report.md
  - feature_request.md
- - ci.yml
  - release.yml
- CODEOWNERS
- pull_request_template.md
- File-Viewer-FS.png
- File-viewer.png
- markdown-style.json
- Markdown-view.png
- Pinned-preview.png
- configuration.md
- install.md
- keys.md
- README.md
- renderers.md
- summoning.md
- usage.md
- windows.md
- fetch-or-build.ps1
- fetch-or-build.sh
- install-renderers.sh
- open-file-viewer-tab.ps1
- open-file-viewer-tab.sh
- open-file-viewer.ps1
- open-file-viewer.sh
- - SKILL.md
- - annotation.rs
  - finder.rs
  - git_apply.rs
  - help.rs
  - infile.rs
  - lineselect.rs
  - mod.rs
  - mouse.rs
  - picker.rs
  - pinned.rs
- - cache.rs
  - compose.rs
  - gateway.rs
  - mod.rs
  - release_policy.rs
  - spotlight_policy.rs
  - status.rs
  - version.rs
- annotation.rs
- app.rs
- config.rs
- context.rs
- editor.rs
- finder.rs
- focus_policy.rs
- fuzzy.rs
- git.rs
- help.rs
- herdr.rs
- highlight.rs
- host.rs
- index.rs
- infile.rs
- input.rs
- intent.rs
- launch.rs
- lib.rs
- main.rs
- open_target.rs
- opener.rs
- picker.rs
- presenter.rs
- preview.rs
- preview_layout.rs
- proc.rs
- prompt.rs
- render.rs
- root.rs
- search.rs
- text_layout.rs
- tree.rs
- view_policy.rs
- worktree.rs
- - mod.rs
- - presenter__presenter_annotation_editor.snap
  - presenter__presenter_annotations_empty.snap
  - presenter__presenter_annotations_populated.snap
  - presenter__presenter_annotations_scrolled.snap
  - presenter__presenter_dirty_dir_glyph.snap
  - presenter__presenter_discard_confirm_switch.snap
  - presenter__presenter_empty_directory.snap
  - presenter__presenter_empty_no_files.snap
  - presenter__presenter_finder_empty_query.snap
  - presenter__presenter_finder_with_matches.snap
  - presenter__presenter_help.snap
  - presenter__presenter_line_select_marker.snap
  - presenter__presenter_line_select_range.snap
  - presenter__presenter_loading.snap
  - presenter__presenter_passive_range_flash.snap
  - presenter__presenter_picker.snap
  - presenter__presenter_quit_confirm.snap
  - presenter__presenter_quit_confirm_capped.snap
  - presenter__presenter_search_highlight.snap
  - presenter__presenter_wide.snap
  - presenter__remote_notice_combined.snap
  - presenter__remote_notice_spotlight_only.snap
  - presenter__remote_notice_update_only.snap
  - presenter_narrow__presenter_narrow_annotations.snap
  - presenter_narrow__presenter_narrow_content.snap
  - presenter_narrow__presenter_narrow_tree.snap
  - presenter_pinned__narrow_active.snap
  - presenter_pinned__narrow_pinned.snap
  - presenter_pinned__narrow_tree.snap
  - presenter_pinned__origin_cross_worktree.snap
  - presenter_pinned__origin_detached.snap
  - presenter_pinned__origin_named_branch.snap
  - presenter_pinned__tree_hidden_two_preview.snap
  - presenter_pinned__wide_three_region.snap
- annotations.rs
- changed_jump.rs
- ci_workflow.rs
- cli_smoke.rs
- compact_dirs.rs
- controller.rs
- controller_async.rs
- docs_consistency.rs
- e2e_annotations.rs
- e2e_editor.rs
- e2e_help.rs
- e2e_keyboard.rs
- e2e_nongit.rs
- e2e_open_target.rs
- e2e_pinned_preview.rs
- e2e_remote_notice.rs
- editor.rs
- fetch_or_build.rs
- fuzzy.rs
- git_baseline.rs
- git_status.rs
- herdr.rs
- highlight.rs
- host_context.rs
- index.rs
- index_perf.rs
- launcher_content.rs
- launcher_ps1.rs
- lineselect.rs
- manifest.rs
- pinned_preview.rs
- presenter.rs
- presenter_narrow.rs
- presenter_pinned.rs
- release_workflow.rs
- remote_notice_integration.rs
- remote_notice_safety.rs
- remote_notice_startup.rs
- render_delegate.rs
- render_escape.rs
- render_perf.rs
- reroot.rs
- reveal_open.rs
- root.rs
- search.rs
- search_integration.rs
- search_perf.rs
- tempdir_sweep.rs
- tree.rs
- tree_filters.rs
- tree_perf.rs
- update_banner.rs
- whats_new_composer.rs
- worktree.rs
.editorconfig
.gitattributes
.gitignore
AGENTS.md
ARCHITECTURE.md
Cargo.lock
Cargo.toml
CHANGELOG.md
CLAUDE.md
config.example.toml
constitution.md
CONTEXT.md
CONTRIBUTING.md
herdr-plugin.toml
LICENSE
README.md
SECURITY.md

# Installation Guide

1. Get the code

git clone https://github.com/smarzban/herdr-file-viewer

Downloads the entire project code from GitHub to your computer.

cd herdr-file-viewer

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Homebrew A package manager for macOS/Linux.

brew install glow git-delta bat # macOS, or use your package manager

Installs the pre-built package via Homebrew — no source build required.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Rust

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Rust (rustup) Installing via rustup also installs cargo.

cargo build --release

Compiles the Rust project.

cargo run

Builds and then immediately runs the program.

✅ If cargo build finishes without errors, it worked. The executable is created under target/.