Launched March 11, 2025
Shellsage

Shellsage

Open-source AI-powered terminal companion with Ollama integration.

FreeOpen SourceCLIAI1,795 impressions#15 of its week

Spent countless hours in the terminal. Always wished for an AI assistant that's actually helpful, fast, and respects privacy—so I built Shell Sage!🚀 Ollama runs locally for offline AI, while it supports cloud APIs for more flexibility. Whether it's fixing errors, generating commands, or optimizing workflows, it's designed to make your CLI experience smoother. Great to hear from you! What would make this an essential part of your setup? Drop your feedback below!

Shellsage is an open-source AI-powered terminal companion that suggests commands, diagnoses errors and runs locally or via cloud LLMs.

for
Developers and sysadmins who work heavily in the command line and want AI assistance.
pricing
open source
license
Apache-2.0
dheerajcl/Shellsage 76 8Pythonupdated 2 years ago
works withOllamaGroqOpenAIAnthropicFireworksDeepSeekOpenRouter

Key features

5 features of Shellsage
  • Error Diagnosis — Detects risky commands and suggests safer alternatives in real time.
  • Natural Language Commands — Translates plain-English requests into executable shell commands.
  • Multi-Provider Support — Works with Groq, OpenAI, Anthropic, Fireworks, DeepSeek and OpenRouter.
  • Model Management — Easily switch among multiple local and cloud models via the CLI.
  • Safety Confirmation — Interactive prompts confirm destructive actions before execution.

Use cases

  • Fix a mistaken ‘rm -rf /important-folder’ command before it runs
  • Generate a backup script for all .js files with a single prompt
  • Query system metrics like memory usage using natural language
  • Create complex multi-step workflows (e.g., build, test, deploy) via AI
  • Switch to a local LLM for fully private command generation

Shellsage vs alternatives

ShellsageGemini CLIAiderOpenCodeWarp
Best forPrivacy-first AI terminal assistantGoogle-backed terminal AIAI pair-programmingAI coding agentModern terminal with AI
PricingOpen sourceFreeFreeFreeSubscription
DevHunt upvotes00000
LaunchedMar 2025————
  • Shellsage vs Gemini CLI: Gemini CLI is Google’s open-source terminal AI, while Shellsage focuses on Ollama-based privacy and multi-provider cloud support.
  • Shellsage vs Aider: Aider provides AI pair-programming inside the terminal, whereas Shellsage emphasizes command generation and safety checks.
  • Shellsage vs OpenCode: OpenCode is an open-source coding agent; Shellsage targets broader CLI assistance beyond code, including system commands.
  • Shellsage vs Warp: Warp offers a modern terminal UI with built-in AI, while Shellsage is a CLI-only companion that can run locally or via cloud APIs.

Shellsage FAQ

How does local mode differ from cloud?+

Local mode runs LLMs via Ollama on your machine, keeping all data private; cloud mode uses external APIs and requires an internet connection.

Which models are officially supported?+

Local models like llama3:8b-instruct-q4_1, mistral:7b-instruct-v0.3, phi3:mini-128k-instruct; cloud providers include Groq, OpenAI, Anthropic, Fireworks, DeepSeek and OpenRouter.

How to switch providers?+

Use the ‘shellsage config --mode’ command or the interactive setup wizard to select a different cloud provider or local model.

What are the system requirements?+

Python 3.8+, at least 4 GB RAM for local models, and an internet connection for initial setup or cloud mode.

Summarized by DevHunt from shellsage.vercel.app · Oct 8, 2026. Details may change; check the official site.