wfxr/forgit
Forgit
forgit is a shell-based interactive CLI wrapper that uses a fuzzy finder to transform Git output into selection menus. It functions as a workflow accelerator and history browser, replacing manual command entry with searchable interfaces for version control operations.
The tool provides specialized managers for Git worktrees and an interactive history browser for visualizing commit logs, reflogs, and blame data. It differentiates itself by wrapping native Git subcommands in selection logic, allowing users to pick targets before executing final operations.
Its capabilities cover interactive file staging, branch management, and guided rebase operations such as cherry-picks and commit fixups. It also includes tools for interactive change restoration, stash management, and the generation of ignore and attribute files.
The project supports native Git subcommand integration via aliases and provides shell tab completion scripts. Configuration for command behavior, keyboard shortcuts, and output pagers is handled through system environment variables.
Features
- Fzf-Based Git Interfaces - Provides a command-line interface utilizing fzf to create interactive menus for Git operations.
- Git Wrappers - Wraps native Git subcommands in fuzzy-searchable selection menus to augment standard version control operations.
- Shell Command Pipelines - Chains git commands and system utilities through standard Unix shell pipes to process version control data.
- Git Workflow Utilities - Offers interactive pickers for common local Git operations like staging files and switching branches.
- Git History Navigation - Provides an interactive interface for navigating through Git commit logs, reflogs, and blame data.
- Git Metadata Search - Provides a fuzzy-search interface to browse and locate specific points in commit logs, reflogs, and blames.
- Command Wrapping - Implements logic to wrap native git subcommands in interactive selection menus before execution.
- Interactive Output Pickers - Transforms Git command output into selectable lists to execute operations without typing full command strings.
- Interactive History Browsers - Ships an interactive browser for visualizing commit logs and reflogs with customizable formatting.
- Git Command Execution - Executes version control operations through an interactive menu to eliminate manual command entry.
- Interactive Command Pickers - Accelerates common git actions like switching branches or adding files via an interactive selection menu.
- Subprocess Command Execution - Launches native git binaries as subprocesses and captures their output to drive the interactive selection logic.
- Branch Management - Facilitates branch creation, deletion, and switching through a fuzzy-searchable interface.
- Alias Configurations - Supports defining short keyboard shortcuts for interactive operations via shell environment variables.
- Interactive Diff Viewers - Provides an interactive viewer to browse file changes and diffs to review modifications.
- Subcommand Integrations - Installs interactive workflows as native git aliases to trigger selection logic directly from the git binary.
- Command Configurations - Allows customization of arguments, search options, and pager settings using environment variables.
- Git Worktree Management - Provides an interactive interface for creating and switching between multiple Git worktree directories.
- Rebase Operations - Implements a guided interface for executing cherry-picks, interactive rebases, and commit fixups.
- Interactive Staging Interfaces - Allows users to interactively choose specific files or changes to add to the Git index.
- Work Stashing - Provides a searchable menu for viewing and interacting with Git stashed changes and reference logs.
- Pager and Finder Configurations - Enables the specification of external programs and preview windows to paginate diffs and logs.
- Environment Variable-Based Configuration - Uses system environment variables to configure tool behavior and visual layouts.
- Custom Pager Integrations - Integrates with external system pagers to handle the display of large logs and diffs in the terminal.
- Command Line Helpers - Fuzzy-finder utility for common git operations.
- Developer Utilities - Git utility using fuzzy finder.
