https://github.com/jxdones/marten
A fast terminal workspace for reviewing local Git changes before they become a PR/MR
https://github.com/jxdones/marten
git ratatui tui
Last synced: 21 days ago
JSON representation
A fast terminal workspace for reviewing local Git changes before they become a PR/MR
- Host: GitHub
- URL: https://github.com/jxdones/marten
- Owner: jxdones
- License: mit
- Created: 2026-05-04T02:54:34.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-09T00:47:43.000Z (27 days ago)
- Last Synced: 2026-06-09T02:24:45.984Z (27 days ago)
- Topics: git, ratatui, tui
- Language: Rust
- Homepage:
- Size: 264 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
marten
A fast terminal workspace for reviewing local Git changes before they become a PR/MR.
[](https://ratatui.rs/)
## What is marten?
marten is a Rust Git TUI for reviewing your own work without leaving the terminal.
It opens inside a Git repository and gives you a focused view of your working tree, changed files, and diffs so you can inspect your changes before committing, pushing, or opening a pull/merge request.
marten is currently focused on local working-tree review. Remote PR/MR review, additional Git views, and review-oriented workflows are planned.
## What it does
marten currently supports:
- changed files grouped by status in a collapsible tree
- insertion/deletion counts per file
- staged, unstaged, partial, untracked, and conflicted file states
- continuous review mode where all files flow as one scrollable document, sidebar selection follows scroll position
- single-file mode where sidebar selection controls which file is shown
- diff hunks for the selected file
- hunk navigation and diff scrolling
- optional diff line numbers
- repository, branch, ahead/behind, and change counts in the top bar
- repository refresh without leaving the TUI
## Why?
Code review often starts before a PR or MR exists. marten is meant for that moment when you want to quickly
inspect your own changes, move through files and hunks, and catch obvious mistakes while staying in your terminal.
## Install
```bash
make install
```
Requires Rust 1.85 or newer.
## Run locally
```bash
make run
```
Run `marten` from inside a Git repository.
```bash
marten
```
## Keybindings
| Key | Action |
| --- | --- |
| `tab` / `shift+tab` | Move focus between panels |
| `0` | Focus diff |
| `1` | Focus files |
| `j` / `k` | Navigate files or scroll the diff |
| `g` / `G` | Jump to first or last file |
| `enter` / `space` | Collapse or expand the selected directory |
| `[` / `]` | Move between diff hunks |
| `l` | Toggle diff line numbers |
| `v` | Toggle between continuous and single-file review mode |
| `r` | Refresh repository state |
| `q` / `ctrl+c` | Quit |
## Development
To see all the available options, run `make help`.
```bash
make build
make run-release
make check
make test
make lint
make fmt
make ci
make ci-full
```
For UI testing with local untracked files:
```bash
make dev-files
make clean-dev-files
```
## License
MIT