Update help command with all new features and mouse actions

2026-01-31 23:48:40 +00:00
parent 56d6b31b2f
commit 06743d5e7f
11 changed files with 1009 additions and 0 deletions
--- a/EnhancedTerminal-Distribution/QUICK_REFERENCE.md
+++ b/EnhancedTerminal-Distribution/QUICK_REFERENCE.md
@@ -0,0 +1,257 @@
+# Enhanced Terminal v3.0 - Quick Reference Card
+
+## 🎯 Essential Shortcuts
+
+| Shortcut | Feature | Description |
+|----------|---------|-------------|
+| `Cmd+R` | **History Search** | Fuzzy search through all commands |
+| `Cmd+K` | **AI Generator** | Generate commands from descriptions |
+| `Cmd+P` | **Snippets** | Quick access to saved commands |
+| `Tab` | **Auto-complete** | Accept command suggestion |
+| `Cmd+T` | **New Tab** | Open new terminal session |
+| `Cmd+W` | **Close Tab** | Close current tab |
+| `Cmd+,` | **Settings** | Configure terminal |
+
+## 🔍 History Search (Cmd+R)
+
+```
+Press Cmd+R → Type search term → Enter to use
+```
+
+**Examples:**
+- Search "docker" → finds all docker commands
+- Search "git commit" → finds commit commands
+- Search "find" → finds all find commands
+
+## 💡 Auto-Suggestions
+
+```
+Start typing → Gray suggestion appears → Press Tab to accept
+```
+
+**Example:**
+```
+$ git st█
+      status  ← Press Tab
+```
+
+## 🤖 AI Command Generator (Cmd+K)
+
+**Setup Ollama (Free):**
+```bash
+brew install ollama
+ollama pull llama3.2:latest
+```
+
+**Use:**
+```
+Cmd+K → Describe task → Generate → Use Command
+```
+
+**Examples:**
+- "find all PDF files larger than 10MB"
+- "show disk usage sorted by size"
+- "kill process on port 8080"
+
+## 📚 Command Snippets (Cmd+P)
+
+**Built-in Categories:**
+- Files: `ls -lah`, `find`, `du -sh`
+- Git: `git status`, `git log`, `git commit`
+- Docker: `docker ps`, `docker images`
+- Network: `lsof -ti:PORT`, `netstat`
+- System: `ps aux`, `uname -a`
+
+**Add Custom:**
+```
+Cmd+P → Add New → Fill details → Save
+```
+
+## 🎨 Themes
+
+**Available:**
+- Dracula (default) - Modern dark purple
+- Solarized Dark - Low contrast
+- Nord - Arctic inspired
+- Classic - Retro green
+
+**Change:**
+```
+Cmd+, → Select theme → Apply
+```
+
+## 📑 Multiple Tabs
+
+```
+Cmd+T     → New tab
+Cmd+W     → Close tab
+Click tab → Switch tab
+```
+
+**Each tab:**
+- Independent shell session
+- Own command history
+- Separate working directory
+
+## ⚙️ Settings (Cmd+,)
+
+**Configure:**
+- Theme selection
+- Font size (8-72pt)
+- Auto-suggestions (on/off)
+- AI provider (None/OpenAI/Ollama)
+- API keys and URLs
+
+## 🔤 Font Size
+
+```
+Cmd+Plus  → Increase
+Cmd+Minus → Decrease
+Cmd+0     → Reset to 14pt
+```
+
+## 💻 Built-in Commands
+
+```bash
+clear  # Clear screen
+help   # Show help
+exit   # Quit application
+```
+
+## 🎓 Common Terminal Commands
+
+### Navigation
+```bash
+ls          # List files
+ls -la      # List all files with details
+cd folder   # Change directory
+cd ..       # Go up one directory
+pwd         # Show current directory
+```
+
+### File Operations
+```bash
+cat file.txt      # View file
+cp src dest       # Copy
+mv old new        # Move/rename
+rm file           # Delete
+mkdir folder      # Create directory
+touch file.txt    # Create empty file
+```
+
+### Search & Find
+```bash
+find . -name "*.txt"           # Find files
+grep "text" file.txt           # Search in file
+grep -r "text" .               # Search recursively
+```
+
+### System Info
+```bash
+date        # Current date/time
+whoami      # Current user
+df -h       # Disk space
+top         # Process monitor
+ps aux      # List processes
+```
+
+### Git Commands
+```bash
+git status              # Check status
+git add .               # Stage all changes
+git commit -m "msg"     # Commit
+git push                # Push to remote
+git pull                # Pull from remote
+git log                 # View history
+```
+
+### Docker Commands
+```bash
+docker ps               # List containers
+docker ps -a            # List all containers
+docker images           # List images
+docker logs <id>        # View logs
+docker exec -it <id> sh # Enter container
+```
+
+## 🔧 Troubleshooting
+
+### AI Not Working
+```bash
+# For Ollama:
+ollama list              # Check if running
+ollama pull llama3.2     # Download model
+
+# For OpenAI:
+# Check API key in Settings (Cmd+,)
+```
+
+### Clear History
+```
+Tools menu → Clear History
+```
+
+### Reset Settings
+```
+Cmd+, → Adjust settings → Close
+```
+
+## 💡 Pro Tips
+
+1. **Build History**: Use the terminal regularly to build up history for better suggestions
+
+2. **Save Complex Commands**: Turn complex commands into snippets for reuse
+
+3. **Use AI to Learn**: Generate commands with AI to learn new techniques
+
+4. **Organize with Tabs**: Keep different projects in separate tabs
+
+5. **Customize Appearance**: Adjust theme and font size for comfort
+
+6. **Combine Features**: 
+   - Find command with Cmd+R
+   - Modify it
+   - Save as snippet with Cmd+P
+
+## 📊 Feature Comparison
+
+| Feature | Traditional Terminal | Enhanced Terminal |
+|---------|---------------------|-------------------|
+| History Search | Ctrl+R (basic) | Cmd+R (fuzzy, visual) |
+| Suggestions | None | Auto-suggestions |
+| Tabs | None | Built-in tabs |
+| AI Help | None | AI command generation |
+| Snippets | Manual aliases | Visual snippet manager |
+| Themes | Limited | 4 beautiful themes |
+
+## 🚀 Workflow Examples
+
+### Development Workflow
+```
+Tab 1: Development server
+Tab 2: Git operations
+Tab 3: Testing
+Tab 4: Logs monitoring
+```
+
+### DevOps Workflow
+```
+Tab 1: SSH to production
+Tab 2: Docker management
+Tab 3: Log analysis
+Tab 4: Monitoring scripts
+```
+
+### Data Analysis Workflow
+```
+Tab 1: Data processing
+Tab 2: Database queries
+Tab 3: Script development
+Tab 4: Results review
+```
+
+---
+
+**Print this reference card for quick access!**
+
+**Full documentation:** See USAGE_GUIDE.md and README.md