EnhancedTerminal/EnhancedTerminal-Distribution/QUICK_REFERENCE.md

# 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