Skip to content

Latest commit

 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

git-tork logo

git-tork

A keyboard-first Git client for your terminal — with mouse support.

npm version license node

Website · Report a Bug · npm


git-tork screenshot

Why git-tork?

Staging, committing, branching, and reading diffs shouldn't require leaving your terminal — or memorizing twenty git flags. git-tork gives you a fast, focused TUI:

  • Zero install — run it with npx
  • Keyboard-first — every action is a keystroke away
  • Mouse support — click panes, rows, and sections when you feel like it
  • Runs anywhere — any terminal with a Node.js ≥ 18 runtime

Quick Start

# Run instantly
npx git-tork

# Or install globally
npm install -g git-tork
git-tork

# Point it at any repo
git-tork /path/to/repo

Features

  • Commit graph — colorized git log --graph across all branches, scrollable
  • Changes view — stage/unstage files, write commit messages, amend the last commit
  • Diff viewer — per-file diffs with syntax-highlighted + / - / @@ lines
  • Branch management — checkout, create branches, browse remotes from the sidebar
  • Push & pull — one keypress, with live status feedback in the header
  • Mouse support — click to focus panes and select list rows
  • Alternate screen buffer — your terminal scrollback stays clean

Keybindings

Global

Key Action
/ Navigate lists
/ Move focus between panes (Sidebar ↔ Commits, or Sidebar ↔ Status ↔ Diff)
p Push
l Pull
q / Ctrl+C Quit

Sidebar

Key Action
Enter Checkout branch / open view / toggle section
Space Collapse or expand a section
r Refresh branches and remotes
Enter on + New Branch Create a new branch

Changes View

Key Action
s Stage highlighted file
u Unstage highlighted file
c Focus the commit message input
a Toggle amend (pre-fills last commit message)
Enter Show diff for highlighted file / submit commit
Esc Cancel text input

Development

git clone https://github.com/sijintv/git-tork.git
cd git-tork
npm install
npm run dev        # run from source with tsx
npm run build      # compile to dist/

Built with React, Ink, and simple-git.

Contributing

Issues and PRs are welcome. If you hit a bug, please include your terminal emulator, OS, and Node version.

License

MIT © Sijin T V

About

Yet another terminal based UI for git. Inspired from fork gui

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages