gpt-cli
Консольный чат с ChatGPT, Claude, Gemini и Cohere: свои ассистенты в YAML, разовые запросы из скриптов и команды оболочки с правкой перед запуском
- 721 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Отправляет ваши запросы и вставленный из stdin текст провайдерам моделей по ключам API
- Ключи можно записать в `~/.config/gpt-cli/gpt.yml`, и тогда они хранятся открытым текстом
- Режим `--execute` запускает в оболочке команду, которую выдала модель, после вашей правки
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/gpt-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Отправляет ваши запросы и вставленный из stdin текст провайдерам моделей по ключам API
- Ключи можно записать в `~/.config/gpt-cli/gpt.yml`, и тогда они хранятся открытым текстом
- Режим `--execute` запускает в оболочке команду, которую выдала модель, после вашей правки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
gpt-cli — консольная программа на Python, которая открывает чат с языковой моделью прямо в терминале. Команда `gpt` запускает интерактивный диалог с ответами, отформатированными как Markdown, а `gpt dev`, `gpt bash` и `gpt general` выбирают ассистента. Ассистент `dev` отвечает как эксперт по разработке и коротко, `bash` выдает только команды оболочки. Подключаются OpenAI, Anthropic, Google Gemini, Cohere и любые API, совместимые с OpenAI, например Together и OpenRouter, а также локальные модели через LM Studio. Для одного вопроса без диалога служит флаг `-p`, он печатает ответ в стандартный вывод и принимает запрос из stdin, поэтому программу удобно вызывать из скриптов. Флаг `-e` просит у ассистента команду и открывает ее в редакторе из `$EDITOR`, чтобы вы поправили ее перед запуском, как в `gpt bash -e "как вывести список файлов"`. Свои ассистенты описываются в `~/.config/gpt-cli/gpt.yml`: модель, температура, `top_p`, стартовые сообщения и подключаемые файлы через `!include`. Режим расширенных рассуждений Claude 3.7 включается флагом `--thinking` с бюджетом токенов. В ходе диалога программа считает токены и показывает стоимость запроса, а флаг `--no_price` этот показ отключает. В диалоге `:c` очищает разговор, `:r` перегенерирует последний ответ, а обратная косая черта с переводом строки включает многострочный ввод.
Для кого. Для разработчиков и администраторов, которые хотят спрашивать модель из терминала на Linux или macOS и держать несколько настроенных ассистентов под разные задачи.
Подходит, если
- Нужен быстрый вопрос к модели без браузера: `gpt dev` отвечает коротко и по-деловому
- Нужно вызывать модель из скрипта и получать ответ в stdout через `gpt -p "..."`
- Команду оболочки проще попросить у модели и поправить в редакторе, чем вспоминать: `gpt bash -e`
- Нужны ассистенты с готовыми ролями и стартовыми сообщениями, описанные в одном YAML
- Хочется видеть расход токенов и цену запроса прямо в диалоге
Не подходит, если
- Нужен агент, который сам читает файлы проекта и правит код: это обычный чат, а для работы с репозиторием лучше подойдет Aider
- Вам нужен единый инструмент с RAG и вызовом инструментов: для этого есть AIChat
- Вы работаете на Windows: в инструкции установки указаны Linux и macOS
- Вам нужна поддержка свежих моделей: репозиторий в последний раз обновлялся в апреле 2025 года, а примеры в нем даны для Claude 3
Пример запроса к агенту
Спроси у модели через gpt-cli, как найти в каталоге все файлы больше 100 МБ, и дай мне поправить команду перед запускомОграничения
- Нужен Python от 3.9 до 3.12. Инструкция установки рассчитана на Linux и macOS.
- Нужны ключи API провайдеров: `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GOOGLE_API_KEY` или `COHERE_API_KEY`. Ключи можно записать в `~/.config/gpt-cli/gpt.yml`, тогда они лежат открытым текстом. API OpenAI и Anthropic из России недоступны, поэтому подойдет совместимый адрес через `OPENAI_BASE_URL` или локальная модель.
- Расширенные рассуждения работают только в моделях Claude 3.7, и при их включении температура принудительно ставится в 1,0.
- Проект в бета-версии, последний выпуск 0.4.3.
- Команда из `--execute` запускается после вашей правки в редакторе, но защиты от опасных команд программа не добавляет, проверять текст надо самому.
Как отключить. Удалите пакет командой `pip uninstall gpt-command-line` и при желании файл `~/.config/gpt-cli/gpt.yml` с настройками и ключами. Если запускали через `uvx`, ничего удалять не нужно: пакет не устанавливался. Из `.bashrc` уберите строку с `OPENAI_API_KEY`, если добавляли ее по инструкции.
Частые вопросы
Как пользоваться ChatGPT и Claude в терминале?
Поставьте `pip install gpt-command-line`, задайте `OPENAI_API_KEY` или `ANTHROPIC_API_KEY` и запустите `gpt`. Модель Claude выбирается флагом `--model`, например `gpt --model claude-3-opus-20240229`.
Как запустить gpt-cli без установки?
Командой `uvx --from gpt-command-line gpt` после экспорта ключа, например `export ANTHROPIC_API_KEY=...`. Пакет скачивается во временную среду, и в системе ничего не остается.
Как получить команду оболочки от модели и не запустить ее вслепую?
Используйте `gpt bash -e "задача"`. Модель вернет команду, программа откроет ее в `$EDITOR`, и выполнение начнется после вашей правки. Лучше всего этот режим работает с моделью gpt-4, пишет автор.
Как подключить OpenRouter, Together или локальную модель?
Задайте `openai_base_url` в файле настроек или переменную `OPENAI_BASE_URL` и добавьте к имени модели префикс `oai-compat:`, например `oai-compat:meta-llama/Llama-3-70b-chat-hf`. Для Azure OpenAI префикс `oai-azure:`.
Как создать своего ассистента с ролью?
Опишите его в `~/.config/gpt-cli/gpt.yml` в разделе `assistants`: имя, модель, температура и стартовые сообщения. Потом запускайте `gpt имя`. Длинный текст роли можно подключить из файла через `!include`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер на вашей машине, через который ChatGPT и Claude правят код, запускают тесты и смотрят Git в локальном репозитории
CodexPro
codexpro
Локальный MCP-сервер, который дает ChatGPT в режиме разработчика инструменты чтения, поиска, правки и проверки для разрешенных вами репозиториев
Терминальный кодинг-агент на Python в манере Claude Code: читает репозиторий, правит файлы, запускает команды, с памятью, подагентами и MCP
CLI на Rust для работы с более чем 20 провайдерами LLM: командный режим, REPL-чат, RAG и вызов инструментов из терминала
Свой MCP-сервер, который дает ChatGPT и другим клиентам доступ к коду на вашей машине: чтение, правки, поиск и запуск команд
Две команды для терминала на Rust: qq отвечает на быстрый вопрос по командной строке, а qa делает один шаг с файлами и командами
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| gpt-cli (эта запись) | нет | 721 | |
| AIChat | нет | 10 533 | CLI на Rust для более чем 20 провайдеров: командный режим, REPL-чат, RAG и вызов инструментов |
| ShellGPT | нет | 12 296 | команда sgpt пишет команды оболочки и код, читает вывод из пайпа, ведет диалоги и вызывает функции |
| LLM | нет | 12 680 | CLI и Python-библиотека для множества моделей: промпты, чаты, инструменты, эмбеддинги и лог в SQLite |
Коротко о README
В репозитории лежат исходники на Python с отдельными модулями провайдеров OpenAI, Azure OpenAI, Anthropic, Google, Cohere и Llama, модуль подсчета стоимости, тесты на pytest и снимок экрана. Обзор открывается запуском через `uvx`, затем идут таблица провайдеров, список возможностей, справка по флагам и описание файла настроек. Отдельные разделы объясняют подключение совместимых API, Claude 3.7 с рассуждениями, Gemini и Cohere. Лицензия MIT.