@git-stunts/git-warp-tui

Interactive terminal graph browser for @git-stunts/git-warp.

Modes

• List mode — Split-pane node browser with search. Node list on the left, properties and edges on the right.
• Graph mode — ELK-positioned ASCII graph in a scrollable viewport with cursor navigation.
• Log mode — Multi-writer patch DAG viewer with writer columns and lamport ordering.

Install

npm install @git-stunts/git-warp-tui

Requires Node 20+ and @git-stunts/git-warp.

Usage

git-warp-view --repo /path/to/repo --graph my-graph

Options

Flag	Description	Default
--repo <path>	Path to git repository	.
--graph <name>	Graph name	default
--list	Start in list mode	(default)
--graph-mode	Start in graph mode
--log	Start in log mode

Keyboard

Key	Action
1 2 3	Switch mode (list / graph / log)
Up Down	Navigate
Left Right	Navigate (graph mode)
Enter	Toggle detail panel (graph mode)
/	Search
Escape	Close overlay / cancel search
?	Help
Ctrl+R	Refresh data
q Ctrl+C	Quit

Programmatic API

import { startTui } from '@git-stunts/git-warp-tui';

await startTui({ repo: '/path/to/repo', graph: 'my-graph', mode: 'list' });

Development

npm install
npm test        # vitest
npm run lint    # eslint
npm run format  # prettier

License

Apache-2.0