super-man/USING-BHELPER-ALIAS.md

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

1. Use quotes for multi-word queries:

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

2. Browse categories to discover commands:

   bhelper category files    # See all file operations
   

3. Explain any command you're curious about:

   bhelper explain "any bash command here"
   

4. 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!