🚀 Introducing Shell Sage – Your AI-Powered Terminal Assistant! 🌐

Dheeraj — Tue, 04 Feb 2025 17:40:00 +0000

Hey everyone! 👋

I’m excited to share Shell Sage, an AI-powered terminal assistant that brings the best of local and cloud AI to your command line. Whether you prefer fully private, offline AI or fast, cloud-based models, Shell Sage adapts to your workflow! It’s in early development (v1.0.0), and I’d love your feedback!

🌟 What’s New?

🏠 Run AI Locally – No API Keys, No Internet Required!

Privacy-first, offline AI with Ollama.
Supports Llama 3, Mistral, Phi-3, and more.
Runs entirely on your machine for security and independence.

  ollama pull llama3:8b-instruct-q4_1  
  shellsage config --mode local --model llama3:8b-instruct-q4_1

☁️ Or Use Cloud APIs for More Power!

Instant access to Groq, OpenAI, Anthropic, Fireworks.ai, OpenRouter, Deepseek.
Switch providers effortlessly:

  shellsage config --mode api --provider groq

⚡ Core Features

✅ Error Diagnosis – Detect and fix risky commands.

  $ rm -rf /important-folder  
  # Shell Sage: ❌ Dangerous! Suggestion: rm -rf ./important-folder

✅ Natural Language to Command Translation

  $ shellsage ask "find large files over 1GB"  
  # Output: find / -type f -size +1G -exec ls -lh {} \;

✅ Interactive Workflows – Confirm commands before execution.

🚀 Get Started in 2 Minutes

Clone the repo:

   git clone https://github.com/dheerajcl/Terminal_assistant.git  
   cd Terminal_assistant  
   ./install.sh

Option 1: Local AI (Recommended for Privacy & Offline Use)

Install Ollama:

   curl -fsSL https://ollama.com/install.sh | sh

Pull a model & configure Shell Sage:

   ollama pull llama3:8b-instruct-q4_1  
   shellsage config --mode local --model llama3:8b-instruct-q4_1

Option 2: API Mode (For Cloud-Based Speed & Power)

Add your API key & configure:

   shellsage config --mode api --provider openai

What I’d Love to Know

💡 Do you prefer local AI or cloud-based models?

💡 What features would make this indispensable for you?

📌 GitHub Repo: [https://github.com/dheerajcl/Terminal_assistant]

🌐 Web-page: [https://shellsage.vercel.app/]

Thanks for checking it out! Let me know your thoughts, and feel free to contribute. 🙌

DEV Community: Dheeraj