AnswerDotAI/shell_sage

What it solves

ShellSage is an AI-powered command-line assistant designed to help users navigate complex shell operations, debug scripts, and manage systems without leaving the terminal. It eliminates the need to manually copy-paste terminal output or errors into a browser-based AI, by integrating directly with the terminal environment.

How it works

ShellSage integrates with tmux to automatically read terminal history and multiple pane histories, providing the AI with immediate context of what the user is doing. It supports multiple LLM providers (including Claude, GPT, and Ollama) via the fastllm library. Users can interact with it by running the ssage command, piping command output directly into it for analysis, or referencing specific tmux panes by their ID. It can also view files, search code, and search the internet for up-to-date information.

Who it’s for

It is designed for developers, system administrators, and power users who spend a significant amount of time in the command line and want an AI assistant that is aware of their current terminal state.

Highlights

• Tmux Integration: Automatically captures terminal and multi-pane history for contextual help.
• Piped Input: Ability to pipe logs or command output directly to the AI for instant explanation.
• Multi-Provider Support: Works with a wide range of LLMs including Claude, OpenAI, Gemini, and local models via Ollama.
• System Interaction: Can create files, edit code, and execute shell commands (with an optional safety layer via safecmd).
• Context Management: Includes a specialized clear command (ssage_clear) to manage what the AI sees in the history buffer.