Parrot - Intelligent CLI Assistant

Parrot is an intelligent CLI assistant that listens for failed command executions and provides witty, AI-powered responses with helpful suggestions. Features multi-backend architecture, three personality levels, transparent AI model management, and seamless shell integration for an enhanced terminal experience.

📦 Installation Options

🎯 RHEL/CentOS/Rocky/Alma/Fedora

🚀 RPM Install

# Add repository

sudo dnf config-manager --add-repo https://repos.musicsian.com/musicsian.repo

# Install package

sudo dnf install parrot

# Complete setup (interactive)

parrot setup

📂 Browse Files ⬇️ Download .repo 📦 Direct RPM

🏛️ Arch Linux

🏛️ AUR Package Available

# Install using yay

yay -S parrot-cli

# Or using paru

paru -S parrot-cli

# Complete setup (interactive)

parrot setup

🏛️ View AUR Page 📄 View PKGBUILD

🤖 Transparent AI Management

Install and forget! Automatic AI model downloads, smart keepalive configuration (OLLAMA_KEEP_ALIVE=1h), and faster llama3.2:3b model for instant responses without manual setup.

🎭 Three Personalities

From gentle guidance to savage roasts. Pick your parrot's attitude: mild, sarcastic, or savage responses to match your mood.

🔗 Shell Integration

Seamless integration with bash and zsh. Automatically detects command failures and responds with contextual assistance.

🎨 Terminal Theming

Color-coded responses with personality-based themes. Configurable colors that adapt to your terminal setup.

Personality Examples

# Mild personality $ git push fatal: No configured push destination 🦜 It looks like you haven't set up a remote repository yet. Try 'git remote add origin <url>' first.

# Sarcastic personality (default) $ rm -rf / rm: cannot remove '/': Permission denied 🦜 Oh wow, trying to nuke the system? How original. Maybe start with 'rm file.txt' and work your way up, hotshot.

# Savage personality $ docker run hello-world docker: command not found 🦜 Docker isn't installed, genius. What's next, asking why your imaginary friends aren't responding either?

Backend Options

Backend Priority System:
1. API Backend      - OpenAI-compatible services (highest quality)
2. Local Backend    - Ollama with llama3.2:3b (privacy-focused)  
3. Fallback Backend - Built-in responses (always available)

Configuration locations:
  ~/.config/parrot/parrot.toml    # User-specific
  /etc/parrot/parrot.toml         # System-wide
  
Environment variables:
  PARROT_API_KEY                  # API authentication
  PARROT_CONFIG                   # Custom config path
  PARROT_PERSONALITY              # Override personality
  PARROT_DEBUG                    # Enable debug mode

Usage Examples

Basic Commands:
  parrot setup                    # Interactive setup wizard
  parrot configure                # Modify configuration  
  parrot status                   # Show current configuration
  parrot mock "git push" 1        # Test a specific command failure

Configuration Management:
  parrot configure backend        # Change AI backend
  parrot configure personality    # Change response style
  parrot configure colors         # Toggle color output
  
Advanced Usage:
  PARROT_DEBUG=true parrot mock "npm install" 1
  PARROT_CONFIG=./test.toml parrot status
  parrot --personality savage mock "docker run" 125

Installation Flows

Scenario 1: API Backend (OpenAI/Compatible)
Install: sudo dnf install parrot
Set API key: export PARROT_API_KEY="your-key"
Configure: parrot setup
Test: parrot mock "git push" 1

Scenario 2: Local AI (Ollama)  
Install Ollama: curl -fsSL https://ollama.com/install.sh | sh
Install Parrot: sudo dnf install parrot
Setup: parrot setup (auto-downloads llama3.2:3b model)
Test: parrot mock "docker run" 125

Scenario 3: Fallback Only
Install: sudo dnf install parrot
Setup: parrot setup (choose fallback)
Test: parrot mock "npm start" 1

Key Features

Intelligence & AI:
- Multi-backend architecture with automatic failover
- OpenAI-compatible API support (GPT, Claude, Gemini, etc.)
- Local LLM support via Ollama integration
- Context-aware responses based on command type and error
- Built-in fallback responses for guaranteed functionality

User Experience:
- Three distinct personalities (mild, sarcastic, savage)
- Terminal color theming with personality-based schemes  
- Interactive setup wizard with guided configuration
- Shell integration for bash and zsh environments
- Comprehensive help and status reporting

Configuration & Deployment:
- TOML-based configuration with environment overrides
- Zero external dependencies for basic operation
- Graceful degradation when backends are unavailable
- RPM packaging with automated post-install setup
- Comprehensive logging and debug capabilities

🦜 Parrot - Intelligent CLI Assistant