ShellGPT CLI
Команда sgpt в терминале: пишет команды оболочки и код, читает вывод из пайпа, ведет диалоги и вызывает функции через модель OpenAI или локальную
- 12 296 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Режим --shell и вызов функций позволяют модели предложить, а при подтверждении выполнить любую команду от вашего пользователя
- Текст запросов и данные из пайпа уходят выбранному провайдеру модели, а ключ API хранится в файле ~/.config/shell_gpt/.sgptrc
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/shellgptОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Режим --shell и вызов функций позволяют модели предложить, а при подтверждении выполнить любую команду от вашего пользователя
- Текст запросов и данные из пайпа уходят выбранному провайдеру модели, а ключ API хранится в файле ~/.config/shell_gpt/.sgptrc
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ShellGPT ставится как Python-пакет и добавляет в терминал команду sgpt. Вы задаете вопрос аргументом или передаете данные через пайп, например git diff для сообщения коммита или хвост docker logs для разбора ошибок. Ключ --shell (-s) возвращает готовую команду под вашу ОС и оболочку и спрашивает, выполнить ее, описать или отменить. Ключ --code (-c) отдает чистый код без пояснений, его можно сразу перенаправить в файл. Диалоги сохраняются под именем сессии (--chat), а режим --repl открывает интерактивный цикл, в том числе с --shell и --code. Командой sgpt --install-integration в .bashrc или .zshrc добавляется горячая клавиша Ctrl+l: она подставляет предложенную команду в строку ввода для правки. Через вызов функций модель получает доступ к вашим скриптам из ~/.config/shell_gpt/functions, а пользовательские роли задают системный промпт.
Для кого. Для разработчиков и администраторов, которые не хотят искать синтаксис find, ffmpeg или docker в браузере и готовы подтверждать каждую команду перед запуском.
Подходит, если
- Нужно вспомнить синтаксис команды: `sgpt -s "find all json files in current folder"` выдаст `find . -type f -name "*.json"` и спросит, выполнять ли
- Из текущих изменений нужно собрать сообщение коммита: `git diff | sgpt "Generate git commit message, for my changes"`
- Журнал контейнера нужно быстро разобрать: `docker logs -n 20 my_app | sgpt "check logs, find errors, provide possible solutions"`
- Команда строится в несколько шагов, и --chat с одним именем сессии позволяет уточнять результат, пока он не подойдет
- Подсказку хочется получать прямо в строке ввода терминала по сочетанию Ctrl+l, не печатая sgpt
Не подходит, если
- Нужен агент, который сам правит файлы проекта и гоняет тесты: sgpt отвечает на запросы и не ведет многошаговую работу над репозиторием
- Вы собираетесь запускать локальные модели и ждете стабильности: разработчик предупреждает, что ShellGPT не оптимизирован под них и может работать не так, как ожидается
- Включены функции, а модель получила широкие права: она может выполнить разрушительную команду, и разработчик советует пользоваться функциями на свою ответственность
- Нет Python 3.10 или новее и нет возможности поставить его или запустить контейнер
Пример запроса к агенту
Поставь ShellGPT, запусти `sgpt -s "сжать все png в текущей папке"` и покажи мне команду до выполненияОграничения
- По умолчанию ShellGPT использует API OpenAI и просит ключ при первом запуске, ключ хранится в ~/.config/shell_gpt/.sgptrc. API платный. Из России он без дополнительных средств недоступен, поэтому укажите свой API_BASE_URL или локальную модель.
- Для локальных моделей через Ollama есть руководство в вики репозитория, но разработчик отмечает, что инструмент под них не оптимизирован.
- Вызов функций включен по умолчанию, отключает его ключ --no-functions.
- Требуется Python 3.10 или новее. Есть образ в Docker.
Как отключить. Удалите пакет командой pip uninstall shell-gpt. Если вы ставили интеграцию с оболочкой, уберите добавленные строки из .bashrc или .zshrc. Настройки и ключ лежат в ~/.config/shell_gpt, историю диалогов хранит каталог chat_cache.
Частые вопросы
Как установить ShellGPT и подключить свой ключ?
Выполните pip install shell-gpt. При первом запуске sgpt спросит ключ OpenAI и сохранит его в ~/.config/shell_gpt/.sgptrc. Тот же файл содержит API_BASE_URL, DEFAULT_MODEL и DEFAULT_EXECUTE_SHELL_CMD.
Как заставить sgpt выдавать только команду?
Используйте sgpt --shell или -s. С флагом --no-interaction команда выводится в stdout без вопроса, и ее можно передать дальше пайпом, например в pbcopy.
Можно ли использовать ShellGPT с локальной моделью Ollama?
Да, в вики репозитория есть руководство по Ollama, а в .sgptrc задается API_BASE_URL. Разработчик предупреждает, что ShellGPT не оптимизирован под локальные модели и результаты могут отличаться.
Как запустить ShellGPT в Docker?
Запустите контейнер ghcr.io/ther1d/shell_gpt с переменной OPENAI_API_KEY и томом для кэша. Переменные OS_NAME и SHELL_NAME подсказывают модели вашу систему и оболочку. Образ можно собрать и самому из Dockerfile командой docker build -t sgpt .
Как добавить собственные функции для sgpt?
Командой sgpt --install-functions ставятся функции по умолчанию, например execute_shell_command. Свои функции пишутся как отдельные .py-файлы в ~/.config/shell_gpt/functions. Докстринг класса уходит модели как описание функции.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл управления разработкой через спецификации: PRD, эпики, задачи, синхронизация с GitHub Issues и параллельные агенты в git worktree
Настольный питомец, который реагирует на работу Claude Code, OpenCode и Cursor через хуки и MCP, не выводя в реплики код, пути и секреты
ChatGPT Shortcut
chatgpt-shortcut
Библиотека готовых промптов с поиском, избранным и расширением браузера AiShort. Интерфейс в основном на китайском
CLI на Go, который держит скиллы, агентов и правила в одном месте и синхронизирует их во все AI-агенты одной командой
Пачка API: скиллы и CLI
Пачка API
Официальные скиллы агентов и CLI для корпоративного мессенджера Пачка: сообщения, чаты, сотрудники, боты, задачи и поиск
Официальная командная строка Todoist со скиллом для агентов: задачи, проекты и входящие из терминала
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ShellGPT (эта запись) | нет | 12 296 | |
| Fabric | нет | 44 485 | набор готовых шаблонов промптов для задач вроде резюме и анализа, а sgpt заточен под команды терминала и код |
| Aider | нет | 49 803 | правит файлы репозитория и коммитит сам, а sgpt только отвечает в терминале |
| Magic CLI | нет | 745 | консольная утилита на Rust |
Коротко о README
Главная страница начинается с установки через pip и объяснения про ключ OpenAI и про локальные модели. Затем идут примеры по порядку: запросы через аргументы и пайпы, генерация команд оболочки, интеграция с Bash и Zsh, режим кода, диалоги, REPL, вызов функций и роли. Ближе к концу описаны файл настроек, полный список аргументов командной строки, запуск в Docker и ссылки на руководства для Azure и Ollama.