Repolode
AnswerDotAI

AnswerDotAI/shell_sage

AI-ассистент командной строки, который анализирует историю терминала в tmux и вывод команд, чтобы помогать с командами и скриптами.

Звёзды
407
Форки
44
Открытые issues
21
Последний коммит
10 дней назад

Что это?

ShellSage — AI-ассистент для терминала, который запускается командой `ssage`. Он работает в связке с tmux: анализирует историю текущей панели или нескольких панелей, чтобы понять, какие команды вы запускали и что пошло не так, а затем предлагает объяснения, исправленные команды и примеры. Для анализа ему также можно передать вывод команды или содержимое файла через pipe.

ShellSage поддерживает несколько провайдеров LLM, включая Claude, OpenAI GPT, Gemini, DeepSeek и OpenRouter, а также локальные и совместимые с OpenAI эндпоинты через base URL в стиле Ollama. Необязательный bash-инструмент на базе библиотеки safecmd со списком разрешённых команд позволяет ассистенту выполнять команды от вашего имени. Кроме того, с вашего разрешения он может просматривать файлы, искать код и вносить правки. Взаимодействия можно записывать в SQLite, а предложенные блоки кода — вставлять в приглашение командной строки с помощью горячей клавиши.

Ключевые возможности

  • 01Анализирует историю панели tmux, чтобы давать ответы с учётом недавних команд и ошибок.
  • 02Принимает через pipe вывод команд или содержимое файлов для анализа.
  • 03Поддерживает несколько провайдеров LLM, включая Claude, GPT, Gemini и API, совместимые с OpenAI.
  • 04Необязательный bash-инструмент со списком разрешённых команд для безопасного выполнения команд.
  • 05Может просматривать файлы, искать в них и редактировать их с разрешения пользователя.
  • 06Записывает взаимодействия в SQLite и вставляет предложенные блоки кода в приглашение командной строки.

Сценарии использования

  • Выяснить, почему не сработала команда оболочки или выражение find, используя историю терминала для контекста.
  • Попросить объяснить логи ошибок из journalctl или вывод другой команды, переданный инструменту через pipe.
  • Разобраться в незнакомых командах, флагах и сценариях работы с git прямо в терминале.
  • Попросить ассистента проверить файлы или выполнить безопасные команды, не выходя из терминала.

Быстрый старт

  1. 1

    Установите ShellSage из PyPI с помощью pip

    pip install shell-sage
  2. 2

    Укажите API-ключ LLM (по умолчанию используется Claude)

    export ANTHROPIC_API_KEY=sk...
  3. 3

    Запустите тестовое приветствие, чтобы проверить, что настройка работает

    ssage hi

Что важно знать

  • Требуется API-ключ платного провайдера LLM, например Anthropic или OpenAI.
  • Лучше всего работает внутри tmux; доступ ко всему контексту терминала зависит от настроек tmux.
  • На значке в README указана лицензия MIT, а в метаданных репозитория — Apache-2.0, поэтому проверьте файл LICENSE.

В подборках

Темы

Частые вопросы

Что такое shell_sage?
AI-ассистент командной строки, который анализирует историю терминала в tmux и вывод команд, чтобы помогать с командами и скриптами. ShellSage — AI-ассистент для терминала, который запускается командой `ssage`. Он работает в связке с tmux: анализирует историю текущей панели или нескольких панелей, чтобы понять, какие команды вы запускали и что пошло не так, а затем предлагает объяснения, исправленные команды и примеры. Для анализа ему также можно передать вывод команды или содержимое файла через pipe.
shell_sage можно использовать бесплатно? Какая у него лицензия?
shell_sage распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
shell_sage всё ещё поддерживается?
Активно поддерживается. Последний коммит в shell_sage — 28 окт. 2026 г..
Для чего можно использовать shell_sage?
Выяснить, почему не сработала команда оболочки или выражение find, используя историю терминала для контекста. Попросить объяснить логи ошибок из journalctl или вывод другой команды, переданный инструменту через pipe. Разобраться в незнакомых командах, флагах и сценариях работы с git прямо в терминале. Попросить ассистента проверить файлы или выполнить безопасные команды, не выходя из терминала.
Как установить shell_sage?
Установите ShellSage из PyPI с помощью pip: pip install shell-sage Укажите API-ключ LLM (по умолчанию используется Claude): export ANTHROPIC_API_KEY=sk... Запустите тестовое приветствие, чтобы проверить, что настройка работает: ssage hi
Где скачать shell_sage?
Исходный код и инструкции по установке — на GitHub: https://github.com/AnswerDotAI/shell_sage

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Кроссплатформенный движок терминального мультиплексора на Rust с типизированными SDK для Rust, Python и TypeScript — для управления CLI- и TUI-приложениями из кода.

2,7 тыс.+17 за неделю167RustOtherОбновлён 14 дней назад