Ellie - The AI-Powered CLI Companion 🤖✨

Meet Ellie - Your all-in-one terminal buddy for system management, Git workflows, and productivity hacks. Built with ❤️ by Tachera Sasi

Getting Started with Ellie 🌟

🛠️ Configuration Setup

When you first run Ellie, you'll need to configure it with your details. Here's how to do it across all operating systems:

1. Run the Configuration Setup: Upon first use, Ellie will automatically prompt you to enter the configuration details.

$ ellie
🔧 Setting up Ellie CLI configuration...
-> Enter your username: Tach
-> Enter your OpenAI API key: sk-123...
-> Enter your Email (optional): this@that.com
✅ Configuration saved successfully at /home/tach/ellie/.ellie.env
🔧 Want to edit it? Open: /home/tach/ellie/.ellie.env

• Username: Your preferred username.
• OpenAI API Key: The API key for ChatGPT integration.
• Email: Optional, used for personalizing interactions.

2. Manual Configuration Editing:

   • If you'd like to modify the configuration later, simply open the .ellie.env file located in your home directory (or equivalent) and adjust the values.

   Linux/MacOS:

   nano ~/.ellie/.ellie.env

   Windows:

   notepad %HOMEPATH%\.ellie\.ellie.env

Where is Your Configuration File Located?

• Linux/MacOS:
  /home/username/ellie/.ellie.env

• Windows:
  C:\Users\YourUsername\ellie\.ellie.env

The configuration file is created automatically, and you can edit it anytime to update details like your OpenAI key or username.

---

What's New in v0.0.5? 🎉

• Git Superpowers 🚀 - Full Conventional Commits workflow with interactive prompts
• Smarter UI 🎨 - Colorized output and emoji-driven interface
• Enhanced Service Control 🔧 - Manage Apache/MySQL with single commands
• Network Wizardry 🌐 - WiFi connection management made simple
• AI Integration 🧠 - Built-in ChatGPT functionality

# Just look how pretty it is! ✨
$ ellie git commit
📝 Conventional Commit Builder
─────────────────────────────
🔧 Type (feat, fix, docs, style, refactor, perf, test, chore, revert) ➜ feat
🎯 Scope (optional) ➜ auth
📌 Description ➜ Add OAuth2 support
💬 Body (optional):
◎ Press Enter twice to finish:
Implemented Google and GitHub providers
Updated configuration schema

💥 Breaking change? (Y/n) ➜ y
📣 Breaking change details ➜ Changed config format
🔗 Issue number (optional) ➜ 42

✨ Commit Preview:
──────────────────
feat(auth): Add OAuth2 support

Implemented Google and GitHub providers
Updated configuration schema

BREAKING CHANGE: Changed config format

Refs #42
──────────────────
✅ Successfully committed and pushed!

---

Installation ⚡

# 1. Clone the repository
git clone https://github.com/tacheraSasi/ellie.git
cd ellie

# 2. Install dependencies
go get github.com/fatih/color

# 3. Build (choose your method)
make build  # or
go build -o ellie

# 4. Run with personality!
./ellie greet

---

Core Features 🌟

🛠️ System Management

# Service Control
ellie start apache    # Start Apache
ellie restart mysql   # Restart MySQL
ellie stop all        # Stop all services

# System Insights
ellie sysinfo         # Show hardware/software specs
ellie network-status  # Detailed network analysis

📂 File Operations

ellie list ~/projects    # Visual directory listing
ellie create-file draft.md  # Create files with safety checks
ellie open-explorer     # Launch GUI file manager

🌐 Network Management

ellie connect-wifi "Coffee Shop" "p4ssw0rd!"  # Secure WiFi connection
ellie network-status                         # Real-time connection stats

🤖 AI Integration

# Chat mode (when no command specified)
ellie How do I fix a 500 error in Apache?

🚀 Git Workflows

ellie git status       # Enhanced status display
ellie git commit       # Interactive conventional commit
ellie git push         # Smart push with pre-checks
ellie setup-git        # Configure credentials securely

---

Conventional Commits Made Easy 📝

Ellie guides you through professional commit messages:

$ ellie git commit
📝 Conventional Commit Builder
─────────────────────────────
🔧 Choose from: feat|fix|docs|style|refactor|perf|test|chore|revert
🎯 Add scope (optional module/component)
📌 Write clear, concise description
💬 Detailed body (Markdown supported)
💥 Breaking changes detection
🔗 Automatic issue reference formatting

Package Management 📦

ellie install neofetch    # Cross-platform installs
ellie update              # System-wide updates

Service Management 🔌

Control services like a pro:

# Start/Restart/Stop services
ellie start apache
ellie restart mysql
ellie stop all

# Systemd integration
ellie check-service nginx  # Coming soon!

---

Why Ellie? 🤔

1. Human-Friendly 😊 - Designed for actual humans
2. Context-Aware 🧠 - Remembers your workflow
3. Safe & Secure 🔒 - Validation on every operation
4. Cross-Platform 🖥️ - Works where you work
5. Extensible 🔌 - Add your own modules

---

Real-World Magic ✨

# Full development workflow
ellie start all          # Fire up services
ellie git commit         # Create perfect commit
ellie connect-wifi Work_Network $PASSWORD  # Stay connected
ellie sysinfo            # Monitor resources

---

Contribution Guide 🌱

Found a bug? Got an idea? Let's build together!

1. Fork the repo
2. Create your feature branch
3. Submit a PR with tests
4. Join our Discord (coming soon!)

# Happy coding! 🎉
ellie --version
Ellie CLI Version: 0.0.3

---

Maintained with ❤️ by Tachera Sasi - Because terminal shouldn't mean terminal boredom!