ForgeCode CLI
Терминальный агент для программирования: диалог, разовый запрос и плагин для zsh, модели OpenAI, Anthropic и других провайдеров на выбор
- 7 637 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Агент читает файлы проекта, записывает патчи и запускает команды оболочки, а `forge commit` сам создает коммит
- Ключи провайдеров хранятся в файле на диске, а контекст разговоров уходит выбранным провайдерам моделей
- Командой `forge setup` меняется `.zshrc`, а `:sync` отправляет содержимое файлов на сервер индексации
Установка
Ручная установка
curl -fsSL https://forgecode.dev/cli | shПри первом запуске предложит войти к провайдеру моделей. Отдельно вход выполняет forge provider login.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает файлы проекта, записывает патчи и запускает команды оболочки, а `forge commit` сам создает коммит
- Ключи провайдеров хранятся в файле на диске, а контекст разговоров уходит выбранным провайдерам моделей
- Командой `forge setup` меняется `.zshrc`, а `:sync` отправляет содержимое файлов на сервер индексации
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ForgeCode — агент с открытым исходным кодом для программирования в терминале, который читает файлы проекта, пишет патчи и запускает команды. Ставится скриптом `curl -fsSL https://forgecode.dev/cli | sh`, при первом запуске предлагает войти в аккаунт провайдера моделей, а `forge provider login` делает это отдельно. Ключи хранятся в файле, а старые переменные окружения при первом запуске переносятся в такое хранилище. Работать можно тремя способами. Команда `forge` без аргументов открывает диалоговый интерфейс в терминале, а `forge -p "задача"` выполняет один запрос и возвращает вас в оболочку; данные можно передать и через канал. Третий способ — плагин для zsh: `forge setup` дописывает его в `.zshrc`, после чего строки с префиксом `:` уходят агенту, например `: перепиши модуль авторизации`. Встроены три агента: `forge` вносит правки и запускает тесты, `sage` только изучает код, `muse` пишет планы в папку `plans/`. Дополнительно есть команда `forge commit`, которая читает diff и пишет сообщение коммита, `forge suggest` для перевода описания в команду оболочки, вложение файлов через `@` и режим `--sandbox`, создающий изолированную рабочую копию git с отдельной веткой. MCP-серверы подключаются командами `forge mcp` или файлом `.mcp.json`, а навыки лежат в папках `.forge/skills/<имя>/SKILL.md` проекта и `~/forge/skills/`.
Для кого. Для разработчиков, которые работают в терминале и хотят подключать модели разных провайдеров к одному агенту.
Подходит, если
- Нужен терминальный агент, который можно направить на модель любого поддерживаемого провайдера и менять модель на лету
- Хочется вызывать агента прямо из строки zsh, не открывая отдельный интерфейс
- Нужны отдельные агенты для разного: один изучает код без правок, другой пишет план, третий вносит изменения
- Сообщения коммитов и подсказки команд оболочки удобно получать от модели, видя результат до выполнения
- Опасные эксперименты нужно вести в отдельной ветке и рабочей копии git
Не подходит, если
- Вы не используете zsh: плагин с префиксом `:` рассчитан на эту оболочку, без него остаются интерфейс `forge` и режим `-p`
- Нужна индексация кода без отправки файлов наружу: по умолчанию `:sync` передает содержимое файлов на сервер ForgeCode, а свой сервер надо поднимать самим
- Нужен агент от самой Anthropic или GitHub: ближе Claude Code или GitHub Copilot CLI из каталога
- Нужен терминальный агент с десктопной версией и режимами разработки и планирования: ближе OpenCode
Пример запроса к агенту
Объясни, как в этом проекте устроено кеширование, и ничего не меняйОграничения
Лицензия Apache-2.0. Нужен ключ или вход у провайдера моделей, а сам агент платных тарифов не включает.
- Семантический поиск через `:sync` отправляет содержимое файлов на `https://api.forgecode.dev`. Адрес меняется переменной `FORGE_WORKSPACE_SERVER_URL`, если вы разворачиваете свой сервер.
- Описание проекта обещает защищенный режим оболочки, но не объясняет, какие у него ограничения: проверьте их, прежде чем выдавать агенту рабочие каталоги.
- Использование файлов `.env` для ключей провайдеров объявлено устаревшим и будет удалено в будущей версии.
- Некоторые настройки команд действуют только в текущей сессии, а другие сохраняются в `~/forge/.forge.toml`: `:model` меняет модель на время сессии, `:config-model` на постоянной основе.
- Время работы инструмента ограничено 300 секундами по умолчанию, предел меняется переменной `FORGE_TOOL_TIMEOUT`.
Как отключить. Уберите строки плагина из `.zshrc`, которые добавила команда `forge setup`, и откройте оболочку заново. Выйти из аккаунта провайдера можно командой `forge provider logout`, а сервер MCP убирает `forge mcp remove`. Файлы настроек лежат в `~/forge/`.
Частые вопросы
Чем отличаются агенты forge, sage и muse?
`forge` вносит изменения: пишет функции, чинит ошибки и запускает тесты. `sage` изучает архитектуру и потоки данных и файлов не меняет. `muse` анализирует структуру и пишет планы в папку `plans/`, тоже не трогая код.
Как прикрепить файл к запросу?
Введите `@` в запросе и нажмите Tab: появится нечеткий поиск по файлам. Выбранный путь вставится как `@[имя файла]` и уйдет агенту в контекст.
Что делает режим `--sandbox`?
Создает изолированную рабочую копию git с отдельной веткой под указанным именем и запускает агента в ней, так что эксперимент не затрагивает основную ветку.
Где лежат навыки и в каком порядке они применяются?
Выше всех стоят навыки проекта в `.forge/skills/<имя>/SKILL.md`, затем глобальные из `~/forge/skills/`, потом встроенные. Встроенных три: `create-skill`, `execute-plan` и `github-pr-description`.
Как задать постоянные правила для агента?
Положите файл `AGENTS.md` в корень проекта или в `~/forge/`: агент читает его в начале каждого разговора. Свои агенты описываются файлами `.md` с YAML-заголовком в `.forge/agents/`.
Как подключить MCP-сервер?
Командой `forge mcp import` или файлом `.mcp.json` с блоком `mcpServers`. Проектный файл имеет приоритет над глобальным `~/forge/.mcp.json`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКодинговый агент на Go для открытых моделей: из беседы делает задачи в отдельных ветках, сам проверяет и вливает результат, ведет все проекты в одном окне
Набор скиллов для проектирования, сборки, аудита и выпуска связок скиллов-плагинов для Claude Code, Cursor, Codex и других агентов
Открытый кодовый агент для терминала, браузера и десктопа, который работает с моделями от OpenAI и Claude до Ollama
Один рантайм для Claude Code, Codex, OpenCode и других: работа принята, только если пройдены проверки, которые агент не писал
Скилл с 25 командами для разбора и доработки промптов, инструментов и схем агентов в Cursor, Claude Code, Gemini CLI и Codex
TUI поверх tmux ведет сессии Claude Code, Codex и других агентов одним списком: статус, быстрые промпты, worktree и ревью диффа
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| ForgeCode (эта запись) | нет | 7 637 | |
| OpenCode | нет | 222 896 | открытый терминальный и десктопный агент с режимами разработки и планирования |
| GitHub Copilot CLI | нет | 11 307 | терминальный агент GitHub Copilot с доступом к репозиториям, issues и pull requests |
Коротко о README
Описание на английском начинается с команды установки и быстрого старта, затем показывает примеры задач: объяснить код, добавить функцию, разобрать ошибку, провести ревью, спроектировать схему базы данных. Дальше объясняются три режима работы и подробно описана система команд с префиксом `:` для zsh: агенты, вложения, управление разговорами, подсказки по git, настройки сессии, навыки и семантический поиск. Завершают раздел справочник параметров и подкоманд, настройка провайдеров, `forge.yaml`, переменные окружения и MCP. В репозитории лежат исходный код на Rust, собственные навыки и команды проекта в `.forge/` и конфигурация среды разработки в контейнере.