scop/bash-completion

Programmable completion functions for bash

View on GitHub ↗Jump to charts ↓

Summary Information

Updated 47 minutes ago
Type:Library / SDKCategory(s):Terminal, Shell & TUIDeveloper Tools
Added to GitGenius on September 19th, 2026
Created on February 9th, 2016
Open Issues & Pull Requests: 227 (+0)
GitHub issues: Enabled
Number of forks: 420
Total Stargazers: 3,523 (+0)
Total Subscribers: 49 (+0)

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 33
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 838 days
Stale 30+ days: 31
Stale 90+ days: 24

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • duplicate (8)
  • ask upstream project (5)
  • enhancement (2)
  • bot (1)
  • bug (1)
  • need info (1)
  • new completion request (1)
  • question (1)

Most active issues this week

Detailed Description

bash-completion is a collection of programmable completion functions for the Bash shell that enhance command-line interaction across numerous commands.

The tool solves the problem of limited command-line completion in Bash, which by default offers only filename suggestions. bash-completion provides completion recipes that deliver intelligent suggestions for options and arguments across many commands. It works by offering a collection of helper functions to assist in creating new completion recipes, along with facilities for loading recipes automatically on demand and installing them system-wide or per-user.

Anyone adopting this tool should know it is most suitable for users who spend significant time at the Bash command line and want faster, more accurate command invocation. It works best on systems where package management is available, as installation via distribution packages is the easiest approach. For systems without readily available packages, installation via standard GNU autotools commands is supported. The tool requires Bash 4.2 or later for straightforward sourcing, though it can accommodate older Bash versions with additional configuration to prevent loading conflicts. macOS users should be aware of platform-specific sourcing requirements, as the standard shell initialization files differ from Linux conventions. The tool provides configuration hooks allowing per-user control over whether programmable completion is enabled when installed system-wide.

Development activity shows consistent maintenance with regular updates to completion recipes and helper functions. The project accepts contributions for new completion recipes and improvements to existing ones. The codebase demonstrates attention to cross-platform compatibility, particularly addressing differences in how various operating systems and shells handle initialization. Documentation covers installation scenarios ranging from package-based setups to manual compilation, and includes troubleshooting guidance for platform-specific issues.