rgburke/grv
Grv
grv is a terminal-based version control client and interactive Git repository browser. It functions as a terminal user interface for browsing commit history, inspecting code differences, and managing branches and tags within Git repositories.
The project distinguishes itself through a graphical commit graph visualizer that renders branching patterns and merge history directly in the terminal. It employs a tiled view layout engine and tabbed workspace management to display multiple repository perspectives simultaneously, supported by real-time filesystem monitoring to update the interface automatically as the repository changes.
The system provides comprehensive capabilities for version control management, including staging files and creating commits. It includes a query engine for filtering repository history using boolean logic and regular expressions, as well as a customizable workflow system for defining key bindings, visual themes, and custom shell command sequences.
Features
- Git Version Control Clients - Functions as a terminal-based version control client for staging files, creating commits, and managing branches.
- Terminal User Interfaces - Provides a terminal-based user interface for browsing commit history, inspecting diffs, and managing Git branches.
- Branch and Tag Management - Provides utilities for creating, deleting, and switching between branches and tags directly from repository views.
- Code Difference Visualizations - Visually compares versions of source code to highlight changes within the repository history.
- Terminal-Based Version Control Interfaces - Implements a keyboard-driven interface for staging files, creating commits, and executing shell commands.
- Git Repository Explorers - Offers a keyboard-driven terminal interface for navigating commit history, file trees, and branch references.
- Git Commit History Visualizers - Provides a visual representation of Git commit sequences and merge patterns to track codebase evolution.
- Git Diff Viewers - Provides specialized interfaces for reviewing code changes and differences between repository states.
- Repository State Monitoring - Monitors root paths and head status to provide real-time repository metadata in the UI.
- Staging and Commit Interfaces - Ships a user interface for staging file modifications and creating commits in version control.
- Commit Graph Visualizers - Renders a topological commit graph showing branching and merge history directly within the terminal.
- Git Command Execution - Runs interactive and non-interactive Git command line tools directly within the interface.
- Filesystem Change Monitors - Tracks modifications to the repository in real time to trigger automatic interface updates.
- Repository Reference Filters - Isolates commits and references using boolean queries, regular expressions, and date comparisons.
- Data Query Filters - Provides a query engine for filtering repository history and references using boolean logic and regular expressions.
- Multi-Criteria Commit Filters - Locates specific commits and references using a query language and multiple search criteria.
- View-State Key Bindings - Routes keyboard sequences to specific internal actions or external scripts based on the currently active view.
- Repository Knowledge Search - Provides search capabilities for locating specific commits and changes within the repository history.
- Shell Command Execution - Allows executing external git and system shell processes using current view state as arguments.
- Custom Key Action Bindings - Assigns arbitrary shell commands or built-in actions to key presses for customized navigation.
- Tabbed Window Organization - Groups commits, differences, and references into named tabs to organize the active workspace.
- Tabbed - Groups related repository views into named tabbed collections to maintain multiple operational contexts.
- Tiling Layout Engines - Manages a dynamic grid of horizontal and vertical splits to display multiple repository perspectives.
- Recursive Split-View Layouts - Divides the workspace into recursive rectangular regions to display multiple repository views simultaneously.
- Workspace Layouts - Arranges interface panels, tabs, and splits to maintain multiple perspectives of a repository.
- Command Line Tools - Listed in the “Command Line Tools” section of the The Book Of Secret Knowledge awesome list.
- Development Tools - Terminal interface for viewing Git repositories.
- Version Control - Git repository viewer with customizable vi keybindings.
