Sage

A fast, ergonomic terminal pager.

Page local files, whole directories, piped stdin, and remote content with a responsive TUI, strong search and find workflows, syntax highlighting, and a robust JavaScript plugin API.

Read the docs CLI JavaScript APIs GitHub

CLI examples

Reference

sage README.md
sage src/
git diff | sage
sage https://example.com/
sage --compile-cache

Inputs can be files, directories, stdin, `http://`, `https://`, or `ssh://` URLs.

Why Sage

A pager-first CLI with a real documentation and automation surface.

Real input coverage

Open one file, a directory worth of files, piped stdin, or remote content without changing tools.

Inputs and modes

Operator ergonomics

Incremental search, cross-tab find, tab navigation, command mode, line index generation, syntax caches, and mouse support.

Keys and commands

Programmable runtime

QuickJS plugins can react to pager events, register commands, persist bounded state, and make HTTP(S) requests.

JavaScript runtime

Docs map

A CLI-first path through usage, configuration, plugins, and the full JavaScript API surface.

Start

Quick start, reading path, and what Sage covers.

Docs

Guides

Build, install, adopt Sage as a pager, and ship plugins.

Guides

CLI

sage modes, input types, flags, keys, config, syntax caches, and diagnostics.

CLI

JavaScript APIs

Plugin runtime, stable sage:* modules, globals, events, and examples.

API

Man pages

sage(1), sage(7), and sage-plugin-api(3) in reader-friendly form.

Man