Files

T

Trilltechnician 3ce1d2ec1f feat(ui): Enhanced flag display with color coordination and clean separation

Display Enhancements:
• Added color-coordinated flag lines (bold yellow flags, dim separator)
• Enhanced bottom preview panel (3 lines → 8 lines)
• Implemented bordered box design with flag 🏴 and description 📝 emojis
• Added clean flag/description separation using AWK-based parsing
• Flag section shows ONLY bash input (e.g., -s sig)
• Description section shows ONLY explanation text
• Cyan bold for flags, green for descriptions in preview
• Handles missing descriptions with dimmed "(No description available)"

Technical Improvements:
• Modified extract_all_flags() to add ANSI color codes to output
• Enhanced browse_flags_fuzzy() preview with intelligent parsing
• Uses AWK field separator on em dash (—) for robust splitting
• Replaced xargs with sed for trimming to avoid flag interpretation
• Added fallback handling for flags without descriptions

Project Organization:
• Moved documentation files to docs/ directory for better structure

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-01 13:22:46 -07:00

3.5 KiB

Raw Blame History

Using the `bhelper` Alias

Alias Configuration

Your bash alias has been updated to use the new Bash Buddy script:

alias bhelper='/home/dell/coding/gitea-projects/bash-buddy/bash-helper.sh'

Location: ~/.bashrc

Activating the Alias

To use the updated alias in your current terminal session:

source ~/.bashrc

Or simply open a new terminal - the alias will be available automatically.

Quick Start

Now you can use bhelper as a shortcut for all Bash Buddy features:

Natural Language Queries

bhelper ask "find large files"
bhelper task "compress a folder"
bhelper ask "search text in files"

Browse by Category

bhelper category files
bhelper category network
bhelper category system
bhelper category text

Explain Commands

bhelper explain "tar -czf archive.tar.gz folder/"
bhelper explain "find . -name '*.txt'"

Original Modes (Still Work)

bhelper ls size              # Direct flag lookup
bhelper                      # Interactive fzf mode
bhelper --help               # Show help with ASCII banner
bhelper --list               # List all commands

Examples

1. Quick Command Lookup

$ bhelper ask "disk usage"

Searching for: "disk usage"

Found 5 matches:

1. Show disk usage of directories
   du -sh */

2. Find files larger than 100MB
   find . -type f -size +100M -exec ls -lh {} \;
...

2. Learn New Commands

$ bhelper category files

Category: File Operations

1. List files sorted by size (largest first)
   ls -lhS

2. Find files larger than 100MB
   find . -type f -size +100M -exec ls -lh {} \;
...

3. Understand Command Flags

$ bhelper explain "tar -czf archive.tar.gz folder/"

Command: tar -czf archive.tar.gz folder/

Description: Compress a folder into tar.gz archive

Flag explanations:
  -c : Create archive
  -z : Compress with gzip
  -f : File name follows

Features

Fast: All queries return in <100ms
Local: No internet required
Smart: Understands natural language
Helpful: Shows examples and explanations
Professional: ASCII banner and color-coded output

Help System

View complete help anytime:

bhelper --help

Shows:

ASCII banner
Quick start guide
All available modes
Examples for each feature
Requirements and dependencies

Tips

Use quotes for multi-word queries:

bhelper ask "find large files"  # ✓ Correct
bhelper ask find large files    # ✗ Will only search "find"

Browse categories to discover commands:

bhelper category files    # See all file operations

Explain any command you're curious about:

bhelper explain "any bash command here"

Original direct lookup still works:

bhelper ls size    # Quick flag reference

Version

Bash Buddy v2.0.0 - Phase 1 Complete

With natural language queries, 20-task database, and intelligent search!

Repository

All code is version-controlled and pushed to Gitea:

URL: http://localhost:3030/trill-technician/bash-buddy

Latest commits:

13cb602 - docs: Add Phase 1 live demo with examples and benchmarks
7f00dfe - feat: Phase 1 - Add intelligent natural language query system with ASCII banner
effbd8e - feat: Add CLI parameter support for direct command lookup

Enjoy!

You now have a powerful, intelligent CLI assistant at your fingertips with just one command: bhelper

Try it now:

source ~/.bashrc
bhelper ask "compress folder"

🚀 Happy scripting!

3.5 KiB Raw Blame History

Using the bhelper Alias