DEV Community

Dheeraj
Dheeraj

Posted on

πŸš€ Introducing Shell Sage – Your AI-Powered Terminal Assistant! 🌐

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  
Enter fullscreen mode Exit fullscreen mode

☁️ 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  
Enter fullscreen mode Exit fullscreen mode

⚑ Core Features

βœ… Error Diagnosis – Detect and fix risky commands.

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

βœ… Natural Language to Command Translation

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

βœ… 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  
Enter fullscreen mode Exit fullscreen mode

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

  1. Install Ollama:
   curl -fsSL https://ollama.com/install.sh | sh  
Enter fullscreen mode Exit fullscreen mode
  1. Pull a model & configure Shell Sage:
   ollama pull llama3:8b-instruct-q4_1  
   shellsage config --mode local --model llama3:8b-instruct-q4_1  
Enter fullscreen mode Exit fullscreen mode

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

  1. Add your API key & configure:
   shellsage config --mode api --provider openai  
Enter fullscreen mode Exit fullscreen mode

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. πŸ™Œ


Top comments (0)