refactor: rebrand bash-helper to super-man + ESC returns straight to menu

Rename bash-helper.sh -> super-man.sh and update all docs/tests to the
super-man name and alias. In interactive mode, pressing Esc in the flag
browser now returns directly to the home menu, removing the intermediary
"Press Enter to search another command" prompt.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
leetcrypt
2026-06-05 20:52:18 -07:00
parent 06bec2d249
commit 2fb20b0682
22 changed files with 419 additions and 412 deletions
+23 -23
View File
@@ -2,7 +2,7 @@
## Overview
Successfully implemented Phase 1 of the Bash Buddy enhancement proposal, adding intelligent natural language query capabilities while maintaining fast, local operation.
Successfully implemented Phase 1 of the Super Man enhancement proposal, adding intelligent natural language query capabilities while maintaining fast, local operation.
## What Was Added
@@ -27,9 +27,9 @@ Each task includes:
#### **ask** mode - Natural language queries
```bash
bash-helper ask "find large files"
bash-helper ask "compress folder"
bash-helper ask "search text in files"
super-man ask "find large files"
super-man ask "compress folder"
super-man ask "search text in files"
```
Features:
@@ -40,26 +40,26 @@ Features:
#### **task** mode - Task descriptions
```bash
bash-helper task "show disk usage"
bash-helper task "download file from url"
super-man task "show disk usage"
super-man task "download file from url"
```
(Same as `ask` mode - both use keyword search)
#### **category** mode - Browse by category
```bash
bash-helper category files
bash-helper category network
bash-helper category system
bash-helper category text
super-man category files
super-man category network
super-man category system
super-man category text
```
Shows all tasks in a category with compact format.
#### **explain** mode - Explain commands
```bash
bash-helper explain "tar -czf archive.tar.gz folder/"
bash-helper explain "find . -name '*.txt'"
super-man explain "tar -czf archive.tar.gz folder/"
super-man explain "find . -name '*.txt'"
```
Features:
@@ -87,16 +87,16 @@ Results sorted by relevance score, filters out words <3 characters.
All original modes still work:
```bash
bash-helper # Interactive fzf mode
bash-helper ls size # Direct flag lookup
bash-helper --list # List commands
bash-helper --help # Show help
super-man # Interactive fzf mode
super-man ls size # Direct flag lookup
super-man --list # List commands
super-man --help # Show help
```
## Technical Implementation
### Files Modified
- **bash-helper.sh** (+370 lines)
- **super-man.sh** (+370 lines)
- Added database reading and search functions
- Implemented keyword matching algorithm with scoring
- Added 4 new display modes
@@ -152,7 +152,7 @@ All modes tested and working:
```bash
# Find large files
$ bash-helper ask "find large files"
$ super-man ask "find large files"
Found 5 matches:
1. Find files larger than 100MB
@@ -163,7 +163,7 @@ Found 5 matches:
...
# Specific query (single result with details)
$ bash-helper ask "symlink"
$ super-man ask "symlink"
Task: Create symbolic link to file or directory
Category: files
@@ -185,7 +185,7 @@ Examples:
### Browse by Category
```bash
$ bash-helper category files
$ super-man category files
Category: File Operations
@@ -203,7 +203,7 @@ Category: File Operations
### Explain Commands
```bash
$ bash-helper explain "tar -czf archive.tar.gz folder/"
$ super-man explain "tar -czf archive.tar.gz folder/"
Command: tar -czf archive.tar.gz folder/
@@ -217,7 +217,7 @@ Flag explanations:
## Educational Value
The enhancements make Bash Buddy a learning platform:
The enhancements make Super Man a learning platform:
1. **Discovery**: Browse categories to learn what's possible
2. **Examples**: See real-world usage patterns for each task
@@ -281,4 +281,4 @@ Local LLM integration with Ollama for complex queries:
- Related task suggestions
- Comprehensive examples
Bash Buddy is now an intelligent CLI assistant while remaining fast, local, and easy to use!
Super Man is now an intelligent CLI assistant while remaining fast, local, and easy to use!