Skip to content
JeHwanYooPublic

About

A Git client for Herdr, focused on the essentials.

Topics

Resources

Contributing

Stars

8 stars

Watchers

0 watching

Forks

Repository files navigation

Herdr Git

Herdr Git

A Git client for Herdr.

Install

Requires Herdr 0.9.0 or later on macOS or Linux.

herdr plugin install JeHwanYoo/herdr-git
herdr plugin action invoke io.github.jehwanyoo.herdr-git.open

The second command toggles the Git pane.

To bind it to prefix+u, add this to ~/.config/herdr/config.toml:

[[keys.command]]
key = "prefix+u"
type = "plugin_action"
command = "io.github.jehwanyoo.herdr-git.open"
description = "toggle Git pane"

Press Ctrl+b, then u to open the Git sidebar on the right.

Features

Feature What you can do
Changes Review changed files, stage or unstage them, and discard tracked changes
Diffs View changes side by side and compare commits or branches
Graph Browse and filter commit history with a lane graph
Files Browse repository files, search file names and contents, and preview files with syntax highlighting, working-tree changes, blame, and line history
Blame & line history See who changed selected lines and review their history
Copy Copy selected code with its file path and line numbers
Commit Create or amend a commit, or ask an Agent to write it
Remotes Add, view, or remove remotes; fetch, pull, and choose where to push
Branches & tags Find and switch branches, create branches and tags, and rename or delete local branches
Rebase Rebase onto a branch or commit, including interactive rebase
Cherry-pick, revert & reset Apply a commit, undo it, or reset to it
Stash Save uncommitted changes and restore them
Workspaces Switch between repositories, Projects, and worktrees

Graph rendering

When Herdr pane graphics are on, the Graph draws antialiased curves and thin rules between commits. Herdr turns them on by default in terminals that support the Kitty graphics protocol. Otherwise the Graph uses box-drawing characters. To turn pane graphics off, add this to ~/.config/herdr/config.toml and restart Herdr:

[terminal]
kitty_graphics = false
kitty_graphics = true kitty_graphics = false
Graph with Kitty graphics enabled Graph with Kitty graphics disabled
Antialiased curves Box-drawing characters

Keyboard shortcuts

Hold Alt to see all keyboard shortcuts.

Development

Install just, then run:

just link   # Build, link the plugin, and bind prefix+u
just check  # Check formatting, Clippy, and tests

Run just link again after changing Rust to rebuild the linked binary.

Contributing

Contribution guide

Changelog

Changelog

License

MIT

About

A Git client for Herdr, focused on the essentials.

Topics

Resources

Contributing

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages