Trilltechnician/super-man
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files
docs/AI-INTEGRATION-OPTIONS.md
+8 -8
View File
@@ -1,8 +1,8 @@
# Local AI Model Integration Options for Bash Buddy
# Local AI Model Integration Options for Super Man
## Overview
This document outlines options for integrating local AI models into Bash Buddy for advanced natural language to bash command translation.
This document outlines options for integrating local AI models into Super Man for advanced natural language to bash command translation.
## Why Local AI Models?
@@ -12,7 +12,7 @@ This document outlines options for integrating local AI models into Bash Buddy f
- **Free**: No API costs
- **Customizable**: Can fine-tune for specific use cases
## Recommended: Ollama (Best for Bash Buddy)
## Recommended: Ollama (Best for Super Man)
### Why Ollama?
@@ -69,7 +69,7 @@ Bash command:"
}
# Usage
bash-helper ai "find all python files modified in last week"
super-man ai "find all python files modified in last week"
```
### Performance
@@ -208,7 +208,7 @@ npm install -g @builder.io/ai-shell
**Note**: Requires OpenAI API key (not fully local), but excellent prompt engineering. Could adapt prompts for local models.
## Recommendation for Bash Buddy
## Recommendation for Super Man
**Use Ollama with CodeLlama 7B**
@@ -223,8 +223,8 @@ npm install -g @builder.io/ai-shell
### Implementation Plan (Phase 3)
```bash
# New mode in bash-helper.sh
bash-helper ai "find all log files modified today and compress them"
# New mode in super-man.sh
super-man ai "find all log files modified today and compress them"
# Workflow:
# 1. Check if Ollama is running
@@ -257,7 +257,7 @@ Bash command:
```bash
# Cache location
~/.cache/bash-helper/ai-responses/
~/.cache/super-man/ai-responses/
# Cache key: MD5 of query
# Cache value: JSON with command, explanation, timestamp
docs/ENHANCEMENT-PROPOSAL.md
+45 -45
View File
@@ -1,7 +1,7 @@
# Bash Buddy Enhancement Proposal
# Super Man Enhancement Proposal
## 🎯 Goal
Transform bash-helper into an intelligent CLI assistant that can:
Transform super-man into an intelligent CLI assistant that can:
- Accept natural language questions
- Return relevant bash commands with examples
- Explain flags in context
@@ -14,13 +14,13 @@ Transform bash-helper into an intelligent CLI assistant that can:
**Use Case:** Simple, common tasks
```bash
bash-helper "list files by size"
super-man "list files by size"
# Returns: ls -lhS
bash-helper "find large files"
super-man "find large files"
# Returns: find . -type f -size +100M -exec ls -lh {} \;
bash-helper "search in files"
super-man "search in files"
# Returns: grep -r "pattern" .
```
@@ -33,11 +33,11 @@ bash-helper "search in files"
**Use Case:** More complex tasks with variations
```bash
bash-helper "compress all logs older than 30 days"
super-man "compress all logs older than 30 days"
# Returns: find /var/log -name "*.log" -mtime +30 -exec gzip {} \;
# Explanation: Finds logs older than 30 days and compresses them
bash-helper "monitor cpu usage every 2 seconds"
super-man "monitor cpu usage every 2 seconds"
# Returns: watch -n 2 'top -b -n 1 | head -20'
```
@@ -50,7 +50,7 @@ bash-helper "monitor cpu usage every 2 seconds"
**Use Case:** Complex, unique queries
```bash
bash-helper --ai "extract all email addresses from files and save to csv"
super-man --ai "extract all email addresses from files and save to csv"
# Uses local Ollama/llama.cpp for understanding
# Generates: grep -roh '\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b' . | sort -u > emails.csv
```
@@ -66,29 +66,29 @@ bash-helper --ai "extract all email addresses from files and save to csv"
```bash
# Ask a question
bash-helper ask "how do I find files modified today"
super-man ask "how do I find files modified today"
# Get command + explanation
bash-helper explain "what does find . -name '*.log' do"
super-man explain "what does find . -name '*.log' do"
# Get examples for a task
bash-helper examples "working with archives"
super-man examples "working with archives"
```
### 2. Task-Based Categories
```bash
# Browse by category
bash-helper category files # File operations
bash-helper category network # Network commands
bash-helper category system # System monitoring
bash-helper category text # Text processing
super-man category files # File operations
super-man category network # Network commands
super-man category system # System monitoring
super-man category text # Text processing
```
### 3. Interactive Examples
```bash
bash-helper demo "find and replace in files"
super-man demo "find and replace in files"
# Shows:
# 1. Basic: sed -i 's/old/new/g' file.txt
# 2. Recursive: find . -type f -exec sed -i 's/old/new/g' {} +
@@ -98,7 +98,7 @@ bash-helper demo "find and replace in files"
### 4. Command Builder
```bash
bash-helper build
super-man build
# Interactive wizard:
# What do you want to do?
# > Find files
@@ -186,8 +186,8 @@ bash-helper build
**Files to create:**
- `commands-db.json` - Task database
- `bash-helper-search.sh` - Search functionality
- `bash-helper-ask.sh` - Natural language queries
- `super-man-search.sh` - Search functionality
- `super-man-ask.sh` - Natural language queries
### Phase 2: Pattern Matching (Week 2)
- Template-based command generation
@@ -205,26 +205,26 @@ bash-helper build
- Graceful fallback
**Integration points:**
- `bash-helper --ai "complex query"`
- `super-man --ai "complex query"`
- Local llama3 or codellama
- Response caching in ~/.cache/bash-helper/
- Response caching in ~/.cache/super-man/
## 🎨 Enhanced CLI Interface
```bash
# Current
bash-helper ls size # Show ls flags with 'size'
super-man ls size # Show ls flags with 'size'
# Enhanced
bash-helper ask "show largest files"
bash-helper task "compress old logs"
bash-helper explain "tar -czf archive.tar.gz folder/"
bash-helper category files
bash-helper search "find duplicate"
bash-helper build # Interactive builder
bash-helper recent # Recently used commands
bash-helper bookmark "useful-find-command"
bash-helper --ai "complex natural language query"
super-man ask "show largest files"
super-man task "compress old logs"
super-man explain "tar -czf archive.tar.gz folder/"
super-man category files
super-man search "find duplicate"
super-man build # Interactive builder
super-man recent # Recently used commands
super-man bookmark "useful-find-command"
super-man --ai "complex natural language query"
```
## 📦 Database Content Areas
@@ -262,7 +262,7 @@ bash-helper --ai "complex natural language query"
## 🔧 Technical Architecture
```
bash-helper (main script)
super-man (main script)
│
├─> Mode Detection
│ ├─> --help, --list (existing)
@@ -290,7 +290,7 @@ bash-helper (main script)
### Fast Lookup Strategy
```bash
# Pre-indexed keyword→command mapping
KEYWORD_INDEX=~/.local/share/bash-helper/keywords.idx
KEYWORD_INDEX=~/.local/share/super-man/keywords.idx
# On first run: build index
# Subsequent runs: instant lookup
@@ -303,7 +303,7 @@ KEYWORD_INDEX=~/.local/share/bash-helper/keywords.idx
### Caching
```bash
~/.cache/bash-helper/
~/.cache/super-man/
├── ai-responses/ # Cached LLM responses
├── recent-commands # History
└── bookmarks.json # User bookmarks
@@ -313,7 +313,7 @@ KEYWORD_INDEX=~/.local/share/bash-helper/keywords.idx
### Scenario 1: New User Learning
```bash
$ bash-helper ask "how to find text in files"
$ super-man ask "how to find text in files"
📖 Task: Search for text in files
@@ -343,7 +343,7 @@ Related tasks:
### Scenario 2: Quick Lookup
```bash
$ bash-helper task "compress folder"
$ super-man task "compress folder"
💡 Quick answer:
@@ -355,13 +355,13 @@ Flags explained:
-f : File name follows
Try also:
bash-helper explain "tar -czf archive.tar.gz folder/"
bash-helper category files
super-man explain "tar -czf archive.tar.gz folder/"
super-man category files
```
### Scenario 3: Complex Query (with AI)
```bash
$ bash-helper --ai "find all python files modified in last week, exclude virtual environments, and count lines of code"
$ super-man --ai "find all python files modified in last week, exclude virtual environments, and count lines of code"
🤖 AI Assistant (using local LLM)
@@ -389,21 +389,21 @@ curl -fsSL https://ollama.com/install.sh | sh
# Pull a code-focused model
ollama pull codellama:7b
# Configure bash-helper
bash-helper config set llm.enable true
bash-helper config set llm.model codellama:7b
# Configure super-man
super-man config set llm.enable true
super-man config set llm.model codellama:7b
```
### Usage
```bash
# First time (generates command)
bash-helper --ai "complex query" # ~3s
super-man --ai "complex query" # ~3s
# Second time (cached)
bash-helper --ai "complex query" # <10ms
super-man --ai "complex query" # <10ms
# Clear cache
bash-helper cache clear
super-man cache clear
```
## 📈 Success Metrics
docs/FINAL-FIXES-COMPLETE.md
+6 -6
View File
@@ -1,4 +1,4 @@
# Bash Buddy - Final UI Fixes Complete! ✅
# Super Man - Final UI Fixes Complete! ✅
## Date: 2025-10-28 (Session 2)
@@ -171,7 +171,7 @@ formatted_line="...${COLORIZED_SYNTAX}" # Colorized
### Test 1: Explain Mode
```bash
./bash-helper.sh explain tail
./super-man.sh explain tail
```
**Result**: ✅ PASS
- tail in cyan + bold
@@ -190,7 +190,7 @@ formatted_line="...${COLORIZED_SYNTAX}" # Colorized
### Test 3: Literal Escape Code Check
```bash
./bash-helper.sh explain tar | grep '\\033'
./super-man.sh explain tar | grep '\\033'
```
**Result**: ✅ PASS (No matches)
- No literal `\033` found
@@ -246,7 +246,7 @@ ls: List directory contents [2-char gap] ls [OPTION]... [FILE]...
**Commit**: `3af2b2a`
**Message**: fix(ui): Fix color rendering and flush-right alignment
**Branch**: testing-suite
**Files**: bash-helper.sh (+41, -31 lines)
**Files**: super-man.sh (+41, -31 lines)
**Status**: ✅ Pushed to remote
---
@@ -289,7 +289,7 @@ ls: List directory contents [2-char gap] ls [OPTION]... [FILE]...
### Ready to Create PR!
**PR URL**: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite
**PR URL**: http://localhost:3030/trill-technician/super-man/compare/main...testing-suite
**What's Included**:
- Complete testing suite (45+ tests)
@@ -300,7 +300,7 @@ ls: List directory contents [2-char gap] ls [OPTION]... [FILE]...
### To Create PR:
1. Open the URL above
2. Title: `feat: Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements`
2. Title: `feat: Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements`
3. Copy description from `PR-DESCRIPTION.md`
4. Create and merge!
docs/PHASE-1-COMPLETE.md
+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!
docs/PHASE-1-DEMO.md
+15 -15
View File
@@ -14,7 +14,7 @@
### 1. ASCII Banner & Updated Help
```bash
$ bash-helper --help
$ super-man --help
```
**Output:**
@@ -28,9 +28,9 @@ $ bash-helper --help
Your Intelligent CLI Assistant for Bash
QUICK START
bash-helper ask "find large files" # Ask a question
bash-helper category files # Browse by category
bash-helper explain "tar -czf" # Explain a command
super-man ask "find large files" # Ask a question
super-man category files # Browse by category
super-man explain "tar -czf" # Explain a command
MODES
Natural Language Queries:
@@ -53,7 +53,7 @@ MODES
#### Query: "find large files"
```bash
$ bash-helper ask "find large files"
$ super-man ask "find large files"
```
**Output:**
@@ -83,7 +83,7 @@ Tip: Use more specific keywords to narrow results
#### Query: "symlink" (Single Result - Full Details)
```bash
$ bash-helper ask "symlink"
$ super-man ask "symlink"
```
**Output:**
@@ -122,7 +122,7 @@ Related tasks:
### 3. Category Browsing
```bash
$ bash-helper category files
$ super-man category files
```
**Output:**
@@ -162,7 +162,7 @@ Category: File Operations
#### List All Categories
```bash
$ bash-helper category
$ super-man category
```
**Output:**
@@ -174,13 +174,13 @@ Available categories:
network : Network Operations
system : System Monitoring
Usage: bash-helper category NAME
Usage: super-man category NAME
```
### 4. Command Explanation
```bash
$ bash-helper explain "tar -czf archive.tar.gz folder/"
$ super-man explain "tar -czf archive.tar.gz folder/"
```
**Output:**
@@ -206,7 +206,7 @@ Flag explanations:
#### Direct Flag Lookup
```bash
$ bash-helper ls size
$ super-man ls size
```
**Output:**
@@ -293,7 +293,7 @@ All queries tested on the system:
## File Changes
### Modified
- **bash-helper.sh**: +370 lines (now 700+ total)
- **super-man.sh**: +370 lines (now 700+ total)
- Added intelligent search functions
- Implemented 4 new query modes
- Enhanced UI with ASCII banner
@@ -315,7 +315,7 @@ All queries tested on the system:
**Net Change**: +2,048 lines
**Pushed to Gitea**: ✅
**URL**: http://localhost:3030/trill-technician/bash-buddy
**URL**: http://localhost:3030/trill-technician/super-man
## What Users Can Do Now
@@ -339,7 +339,7 @@ All queries tested on the system:
## Educational Value
Bash Buddy is now a **learning platform**:
Super Man is now a **learning platform**:
1. **Discovery**: Browse categories to see what's possible
2. **Examples**: Real-world usage patterns for each task
@@ -373,6 +373,6 @@ The system is designed for continuous improvement. Users can:
---
**Bash Buddy v2.0.0 - Phase 1 Complete** 🚀
**Super Man v2.0.0 - Phase 1 Complete** 🚀
From simple flag lookup to intelligent CLI assistant in one upgrade!
docs/PR-DESCRIPTION.md
+7 -7
View File
@@ -1,8 +1,8 @@
# Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements
# Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements
## Overview
This PR introduces a complete testing suite and comprehensive UI improvements for Bash Buddy, elevating the user experience across all operating modes while ensuring code quality and performance.
This PR introduces a complete testing suite and comprehensive UI improvements for Super Man, elevating the user experience across all operating modes while ensuring code quality and performance.
## What's New
@@ -41,7 +41,7 @@ This PR introduces a complete testing suite and comprehensive UI improvements fo
## Technical Details
### Files Changed
- `bash-helper.sh` - Core improvements (+200 lines)
- `super-man.sh` - Core improvements (+200 lines)
- `test-suite.sh` - New comprehensive testing framework
- Multiple documentation files
@@ -114,25 +114,25 @@ After Selection:
### Run Test Suite
```bash
cd /home/dell/coding/bash/bash-buddy
cd /home/dell/coding/bash/super-man
./test-suite.sh
```
### Test Interactive Mode
```bash
./bash-helper.sh
./super-man.sh
# Try: fuzzy search → select command → browse flags → press Enter → repeat
```
### Test Explain Mode with Examples
```bash
./bash-helper.sh explain find
./super-man.sh explain find
# Look for SYNTAX and EXAMPLE sections
```
### Test Fuzzy Flag Search
```bash
./bash-helper.sh ls
./super-man.sh ls
# Fuzzy flag browser opens automatically after command info
# Type keywords like "color" or "time" to search
```
docs/PR-INSTRUCTIONS.md
+6 -6
View File
@@ -12,7 +12,7 @@
**PR Creation URL:**
```
http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite
http://localhost:3030/trill-technician/super-man/compare/main...testing-suite
```
**Steps:**
@@ -24,7 +24,7 @@ http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite
### Option 2: Via CLI (if authenticated)
```bash
cd ~/coding/bash/bash-buddy
cd ~/coding/bash/super-man
tea pr create --base main --head testing-suite
```
@@ -40,7 +40,7 @@ feat(testing): Add comprehensive testing suite with performance analysis
```markdown
## Overview
This PR adds a complete testing infrastructure for Bash Buddy v2.1.0 with:
This PR adds a complete testing infrastructure for Super Man v2.1.0 with:
- Automated testing for all operating modes
- Performance benchmarking and analysis
- Detailed reporting (JSON, Markdown, HTML)
@@ -144,7 +144,7 @@ Once the PR is created:
git diff main testing-suite
# Or via web interface
http://localhost:3030/trill-technician/bash-buddy/pulls
http://localhost:3030/trill-technician/super-man/pulls
```
### Test the Changes (Optional)
@@ -170,7 +170,7 @@ cat reports/performance-report.md
### Merge via CLI
```bash
cd ~/coding/bash/bash-buddy
cd ~/coding/bash/super-man
git checkout main
git merge testing-suite
git push origin main
@@ -236,7 +236,7 @@ Features:
| Action | Command/URL |
|--------|-------------|
| **Create PR** | http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite |
| **Create PR** | http://localhost:3030/trill-technician/super-man/compare/main...testing-suite |
| **View Branch** | `git log testing-suite` |
| **Run Tests** | `cd tests/ && ./run-all-tests.sh` |
| **View Reports** | `cat tests/reports/performance-report.md` |
docs/README.md
+10 -10
View File
@@ -1,4 +1,4 @@
# Bash Buddy
# Super Man
🚀 CLI assistant for impromptu bash scripting help
@@ -28,24 +28,24 @@ sudo pacman -S fzf # Arch
```bash
# Clone the repository
git clone http://localhost:3030/trill-technician/bash-buddy.git
cd bash-buddy
git clone http://localhost:3030/trill-technician/super-man.git
cd super-man
# Make executable
chmod +x bash-helper.sh
chmod +x super-man.sh
# Optional: Install system-wide
sudo cp bash-helper.sh /usr/local/bin/bash-helper
sudo cp super-man.sh /usr/local/bin/super-man
# Or add to your PATH
echo 'export PATH="$HOME/bash-buddy:$PATH"' >> ~/.bashrc
echo 'export PATH="$HOME/super-man:$PATH"' >> ~/.bashrc
source ~/.bashrc
```
## Usage
```bash
./bash-helper.sh
./super-man.sh
```
### Workflow
@@ -59,7 +59,7 @@ source ~/.bashrc
### Example Session
```
$ ./bash-helper.sh
$ ./super-man.sh
> ls:List directory contents
cd:Change the current directory
@@ -102,7 +102,7 @@ The script includes help for these common bash commands:
### Adding More Commands
Edit the `COMMANDS` array in `bash-helper.sh`:
Edit the `COMMANDS` array in `super-man.sh`:
```bash
COMMANDS=(
@@ -143,7 +143,7 @@ NC='\033[0m' # No Color
```bash
# Add to ~/.bashrc
alias bh='bash-helper.sh'
alias bh='super-man.sh'
```
## Contributing
docs/READY-TO-MERGE.md
+18 -18
View File
@@ -1,4 +1,4 @@
# Bash Buddy v2.1.0 - Ready to Merge! 🚀
# Super Man v2.1.0 - Ready to Merge! 🚀
## PR Status: READY ✅
@@ -56,14 +56,14 @@ bdf3026 docs(pr): Add PR creation instructions and merge guide
### Step 1: Open PR Creation Page
```
URL: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite
URL: http://localhost:3030/trill-technician/super-man/compare/main...testing-suite
```
### Step 2: Fill in PR Details
**Title:**
```
feat: Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements
feat: Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements
```
**Description:**
@@ -80,11 +80,11 @@ Copy the entire contents of `PR-DESCRIPTION.md` into the description field.
## Create PR - Option 2: GitHub CLI (if installed)
```bash
cd /home/dell/coding/bash/bash-buddy
cd /home/dell/coding/bash/super-man
# Using gh CLI
gh pr create \
--title "feat: Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements" \
--title "feat: Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements" \
--body-file PR-DESCRIPTION.md \
--base main \
--head testing-suite
@@ -93,10 +93,10 @@ gh pr create \
## Create PR - Option 3: Tea CLI (if working)
```bash
cd /home/dell/coding/bash/bash-buddy
cd /home/dell/coding/bash/super-man
tea pr create \
--title "feat: Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements" \
--title "feat: Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements" \
--description "$(cat PR-DESCRIPTION.md)" \
--base main \
--head testing-suite
@@ -106,7 +106,7 @@ tea pr create \
### Check Branch Status
```bash
cd /home/dell/coding/bash/bash-buddy
cd /home/dell/coding/bash/super-man
git status
git log main..testing-suite --oneline
```
@@ -117,20 +117,20 @@ git log main..testing-suite --oneline
./test-suite.sh
# Interactive mode
./bash-helper.sh
./super-man.sh
# Explain mode with examples
./bash-helper.sh explain find
./super-man.sh explain find
# Direct mode
./bash-helper.sh grep -i
./super-man.sh grep -i
```
## After Merge
### Update Local Repository
```bash
cd /home/dell/coding/bash/bash-buddy
cd /home/dell/coding/bash/super-man
# Switch to main
git checkout main
@@ -148,25 +148,25 @@ git push origin --delete testing-suite
### Verify Merge
```bash
# Check version
./bash-helper.sh --version
./super-man.sh --version
# Run tests on main
./test-suite.sh
# Test interactive mode
./bash-helper.sh
./super-man.sh
```
### Tag Release (Optional)
```bash
git tag -a v2.1.0 -m "Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements"
git tag -a v2.1.0 -m "Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements"
git push origin v2.1.0
```
## Files to Review
1. **PR-DESCRIPTION.md** - Complete PR description (ready to paste)
2. **bash-helper.sh** - Main script with all improvements
2. **super-man.sh** - Main script with all improvements
3. **tests/** - Complete testing framework
4. **TESTING-SUITE.md** - Testing documentation
5. **PR-INSTRUCTIONS.md** - PR creation guide
@@ -185,7 +185,7 @@ git push origin v2.1.0
## PR URL (Direct Link)
```
http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite
http://localhost:3030/trill-technician/super-man/compare/main...testing-suite
```
**Copy this URL into your browser to create the PR immediately!**
@@ -227,7 +227,7 @@ If you encounter any issues:
## Final Notes
This PR represents a significant upgrade to Bash Buddy:
This PR represents a significant upgrade to Super Man:
- **3,253 net new lines** of functionality
- **50+ practical examples** added
- **45+ automated tests** for quality assurance
docs/SESSION-COMPLETE.md
+4 -4
View File
@@ -1,4 +1,4 @@
# Bash Buddy v2.1.0 - Session Complete! 🎉
# Super Man v2.1.0 - Session Complete! 🎉
## All User Requests Fulfilled
@@ -37,7 +37,7 @@
## What Was Changed
### Files Modified
- `bash-helper.sh` (+111 lines, -86 lines)
- `super-man.sh` (+111 lines, -86 lines)
### New Functions
1. `colorize_syntax()` - Parse and colorize syntax by element type
@@ -122,11 +122,11 @@ Run this to test menu formatting:
## Next: Create PR
**PR URL**: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite
**PR URL**: http://localhost:3030/trill-technician/super-man/compare/main...testing-suite
### Steps:
1. Open the URL above
2. Title: `feat: Bash Buddy v2.1.0 - Testing Suite & Comprehensive UI Improvements`
2. Title: `feat: Super Man v2.1.0 - Testing Suite & Comprehensive UI Improvements`
3. Description: Copy from `PR-DESCRIPTION.md`
4. Create Pull Request
5. Review changes
docs/TEST-ANALYSIS-REPORT.md
+10 -10
View File
@@ -1,4 +1,4 @@
# Bash Buddy v2.1.0 - Test & Performance Analysis Report
# Super Man v2.1.0 - Test & Performance Analysis Report
**Date**: 2025-10-28
**Test Suite Version**: 1.0
@@ -61,11 +61,11 @@ These tests expect static output with flag descriptions, but the new fuzzy flag
**Example**:
```bash
# OLD: Displayed flags statically
./bash-helper.sh ls size
./super-man.sh ls size
# Output: -s, --size print sizes
# NEW: Opens fzf browser
./bash-helper.sh ls size
./super-man.sh ls size
# Opens interactive fuzzy search (requires user interaction)
```
@@ -73,7 +73,7 @@ These tests expect static output with flag descriptions, but the new fuzzy flag
#### 2. Help Display Test (#1)
**Test**: `--help` flag
**Expected**: Output contains "Bash Buddy"
**Expected**: Output contains "Super Man"
**Actual**: Help displays correctly but uses different text
**Impact**: **NONE** - Help displays perfectly
@@ -145,7 +145,7 @@ These tests expect static output with flag descriptions, but the new fuzzy flag
**Test Method**: Manual verification with explain mode
**Result**: PASS
```bash
./bash-helper.sh explain tail
./super-man.sh explain tail
# Colors render properly:
# - tail in cyan + bold
# - [OPTION], [FILE] in yellow
@@ -407,9 +407,9 @@ All **user-facing functionality works perfectly**.
## Files Generated
**Test Logs**: `/home/dell/coding/bash/bash-buddy/tests/logs/`
**Performance Data**: `/home/dell/coding/bash/bash-buddy/tests/performance/`
**Reports**: `/home/dell/coding/bash/bash-buddy/tests/reports/`
**Test Logs**: `/home/dell/coding/bash/super-man/tests/logs/`
**Performance Data**: `/home/dell/coding/bash/super-man/tests/performance/`
**Reports**: `/home/dell/coding/bash/super-man/tests/reports/`
**Key Reports**:
- `test-report.json` - Machine-readable results
@@ -419,7 +419,7 @@ All **user-facing functionality works perfectly**.
**View HTML Report**:
```
file:///home/dell/coding/bash/bash-buddy/tests/reports/performance-report.html
file:///home/dell/coding/bash/super-man/tests/reports/performance-report.html
```
---
@@ -445,6 +445,6 @@ file:///home/dell/coding/bash/bash-buddy/tests/reports/performance-report.html
---
**Report Generated**: 2025-10-28
**Analyst**: Claude (Bash Buddy Test Suite)
**Analyst**: Claude (Super Man Test Suite)
**Version**: 2.1.0
**Branch**: testing-suite
docs/TESTING-SUITE.md
+6 -6
View File
@@ -2,7 +2,7 @@
## Overview
This PR adds a comprehensive testing framework for Bash Buddy v2.1.0 with automated testing for all operating modes, performance benchmarking, and detailed reporting capabilities.
This PR adds a comprehensive testing framework for Super Man v2.1.0 with automated testing for all operating modes, performance benchmarking, and detailed reporting capabilities.
## What's Added
@@ -139,7 +139,7 @@ Plain text format for CI logs.
### Required
- bash 4.0+
- bash-helper.sh (the script being tested)
- super-man.sh (the script being tested)
### Optional
- **jq** - JSON parsing (recommended)
@@ -191,7 +191,7 @@ exit $EXIT_CODE
### GitHub Actions
```yaml
name: Test Bash Buddy
name: Test Super Man
on: [push, pull_request]
jobs:
test:
@@ -226,7 +226,7 @@ jobs:
```
═══════════════════════════════════════════════════════════
Bash Buddy Test Suite
Super Man Test Suite
2025-10-28 00:30:15
═══════════════════════════════════════════════════════════
@@ -234,7 +234,7 @@ jobs:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Test #1: Help display (--help)
✓ PASSED (45ms) - Output contains: "Bash Buddy"
✓ PASSED (45ms) - Output contains: "Super Man"
Test #2: List all commands (--list)
✓ PASSED (32ms) - Output contains: "Available commands"
@@ -392,7 +392,7 @@ cd tests/
## Conclusion
This comprehensive testing suite ensures Bash Buddy maintains high quality and performance standards across all operating modes. With 45+ test cases, performance benchmarking, and automated reporting, we can confidently develop and deploy new features while maintaining backward compatibility.
This comprehensive testing suite ensures Super Man maintains high quality and performance standards across all operating modes. With 45+ test cases, performance benchmarking, and automated reporting, we can confidently develop and deploy new features while maintaining backward compatibility.
**Ready to merge!** 🚀
docs/UI-IMPROVEMENTS-FINAL.md
+10 -10
View File
@@ -1,4 +1,4 @@
# Bash Buddy - Final UI Improvements Complete! ✅
# Super Man - Final UI Improvements Complete! ✅
## Session Date: 2025-10-28
@@ -248,7 +248,7 @@ show_flags "$CMD" "$SYNTAX" "$DESC"
### Test 1: Colorized Syntax in Explain Mode
```bash
./bash-helper.sh explain tar
./super-man.sh explain tar
```
**Result**: ✅
- Command "tar" in cyan + bold
@@ -345,7 +345,7 @@ SYNTAX:
## Files Changed
### `bash-helper.sh`
### `super-man.sh`
**Changes**: +111 lines, -86 lines (net +25)
**Sections Modified**:
@@ -372,7 +372,7 @@ SYNTAX:
**Push Status**: ✅ Pushed to remote
**PR URL**: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite
**PR URL**: http://localhost:3030/trill-technician/super-man/compare/main...testing-suite
---
@@ -415,7 +415,7 @@ Ready to merge: YES ✓
### Option 1: Create PR via Web Interface
```
URL: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-suite
URL: http://localhost:3030/trill-technician/super-man/compare/main...testing-suite
```
1. Open URL
2. Copy PR description from `PR-DESCRIPTION.md`
@@ -423,13 +423,13 @@ URL: http://localhost:3030/trill-technician/bash-buddy/compare/main...testing-su
### Option 2: Test Locally First
```bash
cd /home/dell/coding/bash/bash-buddy
cd /home/dell/coding/bash/super-man
# Test explain mode with colorized syntax
./bash-helper.sh explain find
./super-man.sh explain find
# Test interactive menu (if fzf available)
./bash-helper.sh
./super-man.sh
# Run full test suite
./test-suite.sh
@@ -441,7 +441,7 @@ git checkout main
git pull origin main
git branch -d testing-suite
git push origin --delete testing-suite
git tag -a v2.1.0 -m "Bash Buddy v2.1.0"
git tag -a v2.1.0 -m "Super Man v2.1.0"
git push origin v2.1.0
```
@@ -469,6 +469,6 @@ The result is a professional, polished UI with:
**Created**: 2025-10-28
**Session**: UI Improvements - Color Coordination & UX Fixes
**Branch**: testing-suite (9 commits)
**Files**: bash-helper.sh (+111, -86)
**Files**: super-man.sh (+111, -86)
**Tests**: All passing ✓
**User Approval**: Pending
docs/USING-BHELPER-ALIAS.md → docs/USING-SUPER-MAN-ALIAS.md
+30 -30
View File
@@ -1,11 +1,11 @@
# Using the `bhelper` Alias
# Using the `super-man` Alias
## Alias Configuration
Your bash alias has been updated to use the new Bash Buddy script:
Your bash alias has been updated to use the new Super Man script:
```bash
alias bhelper='/home/dell/coding/gitea-projects/bash-buddy/bash-helper.sh'
alias super-man='/home/dell/coding/gitea-projects/super-man/super-man.sh'
```
**Location:** `~/.bashrc`
@@ -22,39 +22,39 @@ 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:
Now you can use `super-man` as a shortcut for all Super Man features:
### Natural Language Queries
```bash
bhelper ask "find large files"
bhelper task "compress a folder"
bhelper ask "search text in files"
super-man ask "find large files"
super-man task "compress a folder"
super-man ask "search text in files"
```
### Browse by Category
```bash
bhelper category files
bhelper category network
bhelper category system
bhelper category text
super-man category files
super-man category network
super-man category system
super-man category text
```
### Explain Commands
```bash
bhelper explain "tar -czf archive.tar.gz folder/"
bhelper explain "find . -name '*.txt'"
super-man explain "tar -czf archive.tar.gz folder/"
super-man explain "find . -name '*.txt'"
```
### Original Modes (Still Work)
```bash
bhelper ls size # Direct flag lookup
bhelper # Interactive fzf mode
bhelper --help # Show help with ASCII banner
bhelper --list # List all commands
super-man ls size # Direct flag lookup
super-man # Interactive fzf mode
super-man --help # Show help with ASCII banner
super-man --list # List all commands
```
## Examples
@@ -62,7 +62,7 @@ bhelper --list # List all commands
### 1. Quick Command Lookup
```bash
$ bhelper ask "disk usage"
$ super-man ask "disk usage"
Searching for: "disk usage"
@@ -79,7 +79,7 @@ Found 5 matches:
### 2. Learn New Commands
```bash
$ bhelper category files
$ super-man category files
Category: File Operations
@@ -94,7 +94,7 @@ Category: File Operations
### 3. Understand Command Flags
```bash
$ bhelper explain "tar -czf archive.tar.gz folder/"
$ super-man explain "tar -czf archive.tar.gz folder/"
Command: tar -czf archive.tar.gz folder/
@@ -119,7 +119,7 @@ Flag explanations:
View complete help anytime:
```bash
bhelper --help
super-man --help
```
Shows:
@@ -133,28 +133,28 @@ Shows:
1. **Use quotes for multi-word queries:**
```bash
bhelper ask "find large files" # ✓ Correct
bhelper ask find large files # ✗ Will only search "find"
super-man ask "find large files" # ✓ Correct
super-man ask find large files # ✗ Will only search "find"
```
2. **Browse categories to discover commands:**
```bash
bhelper category files # See all file operations
super-man category files # See all file operations
```
3. **Explain any command you're curious about:**
```bash
bhelper explain "any bash command here"
super-man explain "any bash command here"
```
4. **Original direct lookup still works:**
```bash
bhelper ls size # Quick flag reference
super-man ls size # Quick flag reference
```
## Version
**Bash Buddy v2.0.0** - Phase 1 Complete
**Super Man v2.0.0** - Phase 1 Complete
With natural language queries, 20-task database, and intelligent search!
@@ -162,7 +162,7 @@ With natural language queries, 20-task database, and intelligent search!
All code is version-controlled and pushed to Gitea:
**URL:** http://localhost:3030/trill-technician/bash-buddy
**URL:** http://localhost:3030/trill-technician/super-man
**Latest commits:**
- `13cb602` - docs: Add Phase 1 live demo with examples and benchmarks
@@ -171,12 +171,12 @@ All code is version-controlled and pushed to Gitea:
## Enjoy!
You now have a powerful, intelligent CLI assistant at your fingertips with just one command: **`bhelper`**
You now have a powerful, intelligent CLI assistant at your fingertips with just one command: **`super-man`**
Try it now:
```bash
source ~/.bashrc
bhelper ask "compress folder"
super-man ask "compress folder"
```
🚀 Happy scripting!
docs/VERSION-2.1-RELEASE.md
+28 -28
View File
@@ -1,4 +1,4 @@
# Bash Buddy v2.1.0 - AI-Powered Release 🤖
# Super Man v2.1.0 - AI-Powered Release 🤖
## What's New
@@ -7,11 +7,11 @@
Integrated **NL2SH model** for advanced natural language understanding:
```bash
bhelper ai "find all python files modified in last week"
super-man ai "find all python files modified in last week"
# Generated: find /path/to/directory -type f -name "*.py" -mtime -7
bhelper ai "count lines in all javascript files"
bhelper ai "compress all log files older than 30 days"
super-man ai "count lines in all javascript files"
super-man ai "compress all log files older than 30 days"
```
**Features:**
@@ -75,37 +75,37 @@ Filter: -v
### 1. AI Mode (NEW!) 🤖
```bash
bhelper ai "find large files in home directory"
bhelper ai "get network interface information"
super-man ai "find large files in home directory"
super-man ai "get network interface information"
```
### 2. Natural Language Queries
```bash
bhelper ask "compress folder" # Database search
bhelper task "disk usage" # Task search
super-man ask "compress folder" # Database search
super-man task "disk usage" # Task search
```
### 3. Category Browsing
```bash
bhelper category files
bhelper category network
super-man category files
super-man category network
```
### 4. Command Explanation
```bash
bhelper explain "tar -czf archive.tar.gz folder/"
super-man explain "tar -czf archive.tar.gz folder/"
```
### 5. Interactive Mode (Enhanced!)
```bash
bhelper # Browse 90+ commands with fzf
super-man # Browse 90+ commands with fzf
# Select command → Enter filter → See flags
```
### 6. Direct Flag Lookup
```bash
bhelper grep -v # Show grep flags with 'v'
bhelper ls size # Show ls flags about size
super-man grep -v # Show grep flags with 'v'
super-man ls size # Show ls flags about size
```
## Performance
@@ -146,20 +146,20 @@ bhelper ls size # Show ls flags about size
### Try AI Mode
```bash
source ~/.bashrc # Reload alias if needed
bhelper ai "find files larger than 100MB"
super-man ai "find files larger than 100MB"
```
### Try Enhanced Interactive
```bash
bhelper # Opens fzf with 90+ commands
super-man # Opens fzf with 90+ commands
# Type to filter (e.g., "net" for network commands)
# Select → Enter filter term → See relevant flags
```
### All Commands Available
```bash
bhelper --help # See all modes
bhelper --list # List all 90+ commands
super-man --help # See all modes
super-man --list # List all 90+ commands
```
## Installation
@@ -178,26 +178,26 @@ Or open a new terminal.
**Find Python files:**
```bash
$ bhelper ai "find python files modified this week"
$ super-man ai "find python files modified this week"
Generated: find /path/to/directory -type f -name "*.py" -mtime -7
```
**Count lines:**
```bash
$ bhelper ai "count lines in all javascript files"
$ super-man ai "count lines in all javascript files"
Generated: find . -name "*.js" -exec wc -l {} + | awk '{sum+=$1} END {print sum}'
```
**Network info:**
```bash
$ bhelper ai "show my IP address"
$ super-man ai "show my IP address"
Generated: ip addr show | grep 'inet ' | grep -v 127.0.0.1
```
### Interactive Mode Example
```bash
$ bhelper
$ super-man
# Type "tar" → Select "tar:Archive files"
# Enter filter: "extract"
@@ -220,7 +220,7 @@ Your Ollama models:
**Default:** NL2SH (specialized for shell commands)
To switch models, edit `mode_ai()` function in bash-helper.sh
To switch models, edit `mode_ai()` function in super-man.sh
## Troubleshooting
@@ -242,7 +242,7 @@ This is now fixed in v2.1.0! The flag extraction has been completely rewritten.
### Want More Commands in Interactive Mode?
Edit the `COMMANDS` array in bash-helper.sh and add:
Edit the `COMMANDS` array in super-man.sh and add:
```bash
"yourcommand:Description of what it does"
```
@@ -268,9 +268,9 @@ Edit the `COMMANDS` array in bash-helper.sh and add:
## Repository
**Location:** `~/coding/bash/bash-buddy/`
**Location:** `~/coding/bash/super-man/`
**Gitea:** http://localhost:3030/trill-technician/bash-buddy
**Gitea:** http://localhost:3030/trill-technician/super-man
**Latest commit:** 3e5e431
@@ -286,9 +286,9 @@ Edit the `COMMANDS` array in bash-helper.sh and add:
---
**Bash Buddy v2.1.0** - Now with AI! 🚀🤖
**Super Man v2.1.0** - Now with AI! 🚀🤖
Try it now:
```bash
bhelper ai "your complex query here"
super-man ai "your complex query here"
```