dlvhdr/gh-dash
Gh Dash
gh-dash is a terminal user interface (TUI) dashboard and API client for monitoring and managing GitHub pull requests, issues, and notifications. It serves as a repository manager and git workflow tool, allowing users to track project activity and execute development lifecycle tasks directly from the command line.
The project distinguishes itself through a highly configurable layout and keybinding system. It uses custom filter templates to define specific subsets of activity and allows users to associate remote repositories with local filesystem directories to automate branch checkouts.
The tool covers comprehensive pull request and issue orchestration, including lifecycle management, assignee updates, and markdown commenting. It also provides notification triage and real-time data filtering, supported by a customizable interface with configurable themes, column layouts, and pane navigation.
Features
- Productivity Dashboards - Provides a customizable command line workspace with tailored layouts and keybindings for monitoring project activity.
- Terminal User Interfaces - Provides a terminal user interface to manage activity and view repository data from the command line.
- GitHub Clients - Functions as a terminal application that interacts with GitHub APIs to manage issue states, assignees, and comments.
- Repository Path Mappings - Associates remote repository names with local directories to automate the checkout of branches.
- Git Workflows - Facilitates a git-based workflow by checking out remote branches to local directories and reviewing diffs in the terminal.
- GitHub Integration Tools - Provides a terminal interface to track and update pull requests and issues to streamline the development lifecycle.
- Keybinding Configurations - Maps keyboard input to internal commands and shell executions via a configurable lookup table.
- GitHub Notification Filters - Organizes and processes GitHub notifications using custom filters and views to manage activity across repositories.
- Path Mapping Configurations - Maps remote repositories to specific local filesystem directories for correct branch checkout locations.
- Repository Path Mapping - Associates remote repository identifiers with specific filesystem directories to automate git checkout operations.
- Pull Request Listing Tools - Creates custom dashboard sections by applying specific filters and limits to pull request lists.
- Pull Request Management Tools - Implements command-line utilities for managing pull request assignees and metadata.
- Local Branch Checkouts - Automates the process of locating a repository and checking out the corresponding pull request branch locally.
- Pull Request Review Interfaces - Implements a terminal-based interface for submitting approvals, comments, and monitoring CI check statuses on pull requests.
- Pull Request Viewing Tools - Provides a terminal-based interface for inspecting pull request diffs using a configured pager.
- TUI Focus Management - Tracks interface focus and data visibility across multiple panes within a terminal user interface.
- Client-Side Data Filtering - Uses custom filter functions to process raw activity data and populate specific dashboard sections.
- Dashboard Layout Engines - Defines the structural arrangement, size, and placement of panes and columns in the dashboard.
- Dashboard Customizations - Allows defining custom sections in the issues dashboard with personalized titles and layout styles.
- Keyboard Navigation - Provides comprehensive keyboard-driven control for navigating the interface, accessing help, and exiting.
- Layout Configurations - Defines the visual arrangement of columns and sections using external files and schema-based validation.
- Search Filters - Uses custom templating and search filters to define specific subsets of GitHub activity for the dashboard.
- PR Commenting Tools - Allows adding markdown comments to pull requests directly from the terminal.
- Dynamic Search Scopes - Restricts activity filters to the current git repository or specific environment variables at runtime.
- Search Result Filtering - Implements real-time text matching to filter the content of the current interface pane.
- PR Action Workflows - Enables the execution of workflows like approving or merging pull requests directly from notification previews.
- Configuration Import Systems - Loads and merges multiple nested settings files to provide a hierarchy of global and project-specific overrides.
- Global Configuration Managers - Defines global configurations for themes and keybindings with support for project-level overrides.
- Issue Management Utilities - Adds responses to GitHub issues using supported markdown syntax directly from the terminal.
- Issue Trackers - Allows users to assign or remove usernames from GitHub issues via a dedicated input pane.
- Branch Checkout Automation - Creates and switches to a local git branch for a specific issue based on configured local paths.
- Pull Request Merging Tools - Provides automated tools for updating pull request branches with merge commits.
- Pull Request Monitors - Tracks the status of pull request checks and provides desktop notifications upon completion.
- Real-Time Search Utilities - Provides instant, as-you-type filtering of dashboard sections to refine displayed items in real time.
- Search Query Filters - Provides a search bar for performing ad-hoc queries on notifications scoped to specific repositories.
- Terminal Action Bindings - Provides a system for mapping keyboard input to internal application actions and external terminal commands.
- Item Previews - Displays detailed information for a selected item in a dedicated side pane for quick review.
- Application Behavior Configurations - Defines global and project settings via environment variables, command-line flags, or directory-level files.
- Configuration Modularization - Imports multiple external configuration files recursively to share settings across environments or projects.
- Column Management Interfaces - Provides configuration for the alignment, width, and visibility of columns within the terminal interface.
- Interface Navigators - Implements movement shortcuts to quickly traverse rows, sections, and sidebars.
- Keyboard Shortcuts - Allows users to define custom keyboard shortcuts in a configuration file to trigger specific application actions.
- Data Layout Toggling - Enables switching between different visual representations of data, such as toggling between pull requests and issues.
- Keyboard Navigation Shortcuts - Uses specific keyboard sequences to move focus between different data views and rows.
- View Modes - Supports switching between flat and grouped data layouts for organizing repository information.
