Enhanced bash-it doctor with comprehensive diagnostics and interactive updates #2341
+227
−36
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Implements enhancement requested in issue Bash-it#1745 to provide a concise summary of enabled components via `bash-it doctor` command. The new default behavior shows: - Environment info (OS, Bash version, config file location) - Bash-it version (commit, tag, update status) - How bash-it is loaded (with context from .bashrc/.bash_profile) - Summary of enabled aliases, plugins, and completions This makes it easier for users to: - Share diagnostic info when reporting bugs - Quickly see their current bash-it configuration - Check if their installation is up to date Usage: `bash-it doctor` or `bash-it doctor summary` The existing doctor error/warning modes still work: - `bash-it doctor errors` - `bash-it doctor warnings` - `bash-it doctor all` 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
Enhancements to the bash-it doctor command: **Interactive Update Prompt:** - Offers to update bash-it when behind remote master - Only prompts when safe (no uncommitted changes, can fast-forward) - Performs git merge with --ff-only for safety - Provides clear feedback on update status **Colorful Output:** - Color-coded sections (cyan headers, green labels, yellow warnings) - Visual indicators (✓ for up-to-date status) - Improved readability for terminal output **Better Configuration Detection:** - Now greps ALL common config files (.bashrc, .bash_profile, .profile) - Shows bash-it loading context from each file found - Previously only checked single config file **Improved Version Display:** - Shows commits ahead of latest tag (e.g., "v3.1.2 +3") - Clearer version information for users not on tagged releases **Documentation Updates:** - Updated bug_report.yml to streamline diagnostic info collection - Added Diagnostics section to README - Emphasizes using `bash-it doctor` for bug reports Related to issue Bash-it#1745 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Enhances the
bash-it doctorcommand to provide comprehensive diagnostic information and interactive update prompts, addressing the feature request in #1745.Changes
1. Comprehensive Diagnostic Summary
The default
bash-it doctor(no arguments) now displays:Environment Information
Version Information
Configuration Loading Details
Enabled Components
2. Interactive Update Prompt
When behind remote master, offers to update with safety checks:
git merge --ff-onlyfor safetybash-it updatefor complex cases3. Colorful Terminal Output
4. Documentation & Templates
bash-it doctoroutput instead of 5+ separate fieldsUse Cases
For Users:
bash-it doctor # Get complete diagnostic info + update prompt if neededFor Bug Reports:
Single command provides all diagnostic info maintainers need, reducing back-and-forth
For System Health Checks:
Quickly see version status, enabled components, and update availability
Testing
Closes
Closes #1745
Screenshots
🤖 Generated with Claude Code
Co-Authored-By: Claude [email protected]