See everything, full screen.

konoma — ~/work/appTREE ⇄ PREVIEW

TREEsort: name ↑ · path: rel

app

▸·src--06-30 09:12

MREADME.md4.2 KBtoday 14:02

Mapp.rs18.6 KBtoday 14:01

·Cargo.toml1.1 KB06-28 18:40

·sample.pdf312 KB06-27 11:05

·data.csv8.4 KB06-27 10:58

j/k:move ↵:preview /:filter o:git F:follow ?:help

PREVIEWREADME.md

Release checklist

bump version — Space toggles, written back to the file

update changelog

tag & publish

docs: CONFIGURATION.md ← Tab focuses, ↵ opens

Tab:link Space:toggle /:search R:raw q:back

Why konoma?

Full-screen previews

No split panes. The tree is full screen, the preview is full screen, and you flip between them with two keys. Markdown renders decorated (tables, Mermaid diagrams, inline images, interactive checkboxes), code gets syntax highlighting, CSV becomes a navigable table, images/PDF/SVG draw as real pixels via kitty graphics.

Built for AI pair work

Put konoma on the left, your coding agent on the right. Follow mode (F) automatically shows the diff of whatever the agent just changed, C lists every uncommitted file, and one key copies @path#L12-34 references to paste into the conversation.

A real git client

Stage, unstage, commit, full-screen diffs, a log, branches, and a custom-rendered commit graph with square corners and a pinnable base branch — all inside the browser.

Config-driven, safe by default

Every format→viewer mapping and every key is declared in one TOML file. Unknown files degrade to a safe screen instead of crashing; deletions go to the trash behind a confirmation; a broken config never bricks the UI.

In action

Documentation

Getting startedInstall, the two-screen model, a five-minute tour.

TutorialA guided tour in seven steps — follow along in your terminal.

Working with an AI agentFollow mode, changed-files view, @path references.

Previews in depthMarkdown, checkboxes, tables, media, copying.

The git suiteHub, diffs, log, commit graph, branches.

Files, bookmarks & tabsFiltering, safe file ops, bookmarks, tabs.

ConfigurationEvery option — UI, colors, preview rules, keys.

Default keymapKey bindings per screen, all rebindable.

Install

cargo binstall konoma       # prebuilt binary (needs cargo-binstall)
# or
cargo install konoma        # build from source

macOS on Apple Silicon is the primary target (Intel macOS and Linux x86_64 have prebuilt binaries too). For image previews you need a terminal that speaks the kitty graphics protocol, such as Ghostty. Then:

konoma [DIR]

Press ? on any screen for help, and take the built-in tour: open samples/tutorial.md from the repository in konoma and learn by doing.