Skip to content

README.md

Latest commit

 

History

History
87 lines (58 loc) · 3.37 KB

README.md

File metadata and controls

87 lines (58 loc) · 3.37 KB

🚀 Windows Enhanced Shell with Expert AI Agent Integration! 🚀

📌 Project Overview

A Python-powered command shell that enhances the Windows command-line experience with modern features like undo functionality, command suggestions, and and integrated Expert AI Agent technology. Designed for developers, system administrators, and power users seeking intelligent CLI assistance.

🤖 Expert AI Agent Features

  • Domain-Specific Expertise - Deep knowledge of Windows CLI commands, syntax, and best practices

  • Conversation Memory - Maintains context across dialogue sessions for natural follow-up questions

  • Intelligent Filtering - Expertly identifies and responds to CLI-related queries while rejecting off-topic requests

  • Context-Aware Responses - Understands technical context, pronouns, and command relationships

  • Professional Architecture - Built with production-grade AI agent patterns including prompt engineering and memory management

  • Hybrid Intelligence - Combines static command knowledge with dynamic AI generation

✨ Key Features

  • Interactive Mode 💬 - A guided experience for executing commands
  • Autocorrection 🎯 - Detects and corrects common typos in commands
  • Undo Command ⏪ - Revert file operations, directory changes, and more
  • Smart Suggestions 💡 - Automatic correction for mistyped commands
  • Rich Visual Output 🎨 - Color-coded messages and formatted results
  • Command History 📜 - Navigate through previously executed commands
  • Enhanced File Operations 📂 - Safer file management with undo support
  • Built-in Help System ❓ - Detailed documentation for all commands

🛠️ Installation

Prerequisites

  • Python 3.7 or higher
  • Windows OS (optimized for Windows 10/11)

Quick Start

# Clone the repository
git clone https://github.com/Do-raa/mycli.git
cd CLI

# Create and activate virtual environment
python -m venv venv
source venv/bin/activate   (on Mac/Linux)  
venv\Scripts\activate  (on Windows)

# Install dependencies
pip install -r requirements.txt

# Configure AI Agent (optional but recommended)
# Create .env file with your OpenAI API key:
# OPENAI_API_KEY=your_api_key_here

# Launch the enhanced shell with AI Agent
python cli/main.py


## 🤖 Using the AI Agent
Once in the shell, simply type ask to start interacting with the AI agent:

bash
C:\> ask
🤖 Expert AI Agent Activated
Type 'exit', 'quit', or 'stop' to end the conversation

💬 Your question: how do I check my IP address?
🤖 Assistant: Use the 'ipconfig' command to display your IP configuration...

➡️ Ask another question? (yes/no) [y/n/yes/no] (y): y

💬 Your question: what about showing all network adapters?
🤖 Assistant: Add the '/all' flag: 'ipconfig /all' shows detailed information for all network adapters...
The assistant understands context and maintains conversation memory, making it perfect for learning Windows command line through natural dialogue.

## 🎯 Example AI Interactions
**"How do I create a scheduled task?"**

**"Explain the difference between PowerShell and CMD"**

**"What's the best way to search for files containing specific text?"**

**"How can I monitor active network connections?"**

**"Show me how to set environment variables permanently"**

Happy Coding! 🚀