Agent Router CLI
CLI router выбирает для задачи агента, модель и уровень усилий по остатку квот подписок и запускает его в панели Herdr.
- 123 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Запускает агентов с правами вашего пользователя и отправляет текст задачи во внешний сервис TypeSafe.
- Читает данные об использовании подписок и хранит ключ в связке ключей.
Установка
- Работает в
Ручная установка
git clone https://github.com/nidhi-singh02/agent-router.git && cd agent-router && npm install && npm run buildКоманды из шага 1 установки в README. В README после клонирования стоит `cd model-router`; здесь подставлено имя клонированной папки.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает агентов с правами вашего пользователя и отправляет текст задачи во внешний сервис TypeSafe.
- Читает данные об использовании подписок и хранит ключ в связке ключей.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Команда `router run` принимает текст задачи и решает, кто ее выполнит: Cursor, Claude Code, Codex или OpenCode, с какой моделью и каким уровнем усилий. Сначала фиксированные правила отсеивают недоступные варианты: выключенные модели, исчерпанные квоты и резерв 40 процентов на общих аккаунтах. Затем сервис TypeSafe ранжирует оставшиеся варианты и выбирает уровень усилий. После выбора router открывает новую панель Herdr, запускает агента под вашим логином, ждет старта и отправляет задачу. Ключи провайдеров не нужны: используются входы, уже выполненные в CLI агентов. Режим `--dry-run` печатает карточку решения и команду запуска без запуска. Опциональный скилл `model-router` учит самого агента передавать следующую фазу работы, например реализацию утвержденного плана.
Для кого. Тем, у кого несколько подписок на кодинг-агентов и кто не хочет вручную выбирать, на какой из них потратить задачу.
Подходит, если
- Квота Claude Code почти выбрана, а у Codex и Cursor есть запас.
- Общий аккаунт команды нельзя расходовать ниже порога резерва.
- Перед запуском хочется увидеть, какую модель выберет роутер, без запуска.
- План согласован, и реализацию надо передать подходящему агенту в новой панели.
Не подходит, если
- Нет ключа TypeSafe: маршрутизация всегда обращается к сервису, запасного режима нет.
- Текст задачи содержит секреты или данные клиентов: он уходит в TypeSafe.
- Herdr не используется: без него запуск возможен только в режиме `--dry-run`.
Пример запроса к агенту
Покажи через `router run --dry-run`, какой агент и модель возьмут задачу «реализуй план из docs/plans/billing.md».Ограничения
Проект в стадии пре-релиза. Нужны Node.js 20 или новее, ключ TypeSafe, хотя бы один агент с выполненным входом и Herdr, а запуск без `--dry-run` работает только внутри панели Herdr. Аккаунты задаются вручную в `.model-router/config.json`, команды добавления нет. Ключ TypeSafe хранится в связке ключей macOS. Запущенный агент получает права вашего пользователя, поэтому проверяйте выбранный маршрут и задачу. Показатели моделей в `models.json` приблизительные, их можно править.
Как отключить. Удалите ссылку `router` из `PATH`, а также символические ссылки на скилл `model-router` в папках скиллов агентов. Конфигурация лежит в `.model-router/`, ключ TypeSafe удаляют из связки ключей отдельно.
Частые вопросы
Как увидеть выбор роутера без запуска агента?
Выполните `router run "<задача>" --dry-run`. Команда выведет карточку решения и команду запуска, панель не откроется.
Откуда router знает остаток квоты?
Из источника, заданного в `collectorPreference` аккаунта: локальные сессии, CLI поставщика, его API или панель в браузере. `router status --usage` показывает остатки.
Что такое резерв 40 процентов?
Для общего аккаунта (`ownership: shared`) роутер не расходует последние 40 процентов квоты, и поле `reserveFloor` ниже этого значения не опускается.
Как подключить скилл к агентам?
Сделайте символические ссылки на `skills/model-router` в `~/.claude/skills`, `~/.codex/skills` и `~/.cursor/skills`, как показано в README.
Что нужно для запуска?
Node.js 20 или новее, ключ TypeSafe, вход хотя бы в один агент (`agent`, `claude`, `codex` или `opencode`) и Herdr для запуска без `--dry-run`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальный шлюз для Claude Code, Codex, OpenCode и других агентов: выбор провайдера моделей, маршрутизация, резервные модели и логи
Мост между локальными CLI-агентами: Codex, Cursor или Claude Code делегируют работу Antigravity, Grok, Kimi и еще семи агентам.
Хуки читают каждый запрос до модели и сначала просят черновик у бесплатной или локальной модели, чтобы беречь квоту Claude.
Один агент запускает других в фоне: Claude Code, Codex, Copilot CLI, Grok Build и Pi, с выбором модели под каждый этап.
Терминальный агент для кода: читает проект, правит файлы и запускает команды, а запросы шлет на лучшую бесплатную модель, которая отвечает сегодня
Каркас из персон, правил и скиллов в чистом Markdown: Maestro раздает работу разным моделям и экономит основной тариф
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Agent Router (эта карточка) | нет | 123 | |
| Claude Code Router | нет | 38 004 | перенаправляет запросы Claude Code к другим провайдерам моделей; Agent Router выбирает самого агента и модель по квоте и запускает его |
| herdr | нет | 48 237 | терминальный мультиплексор для агентов; Agent Router запускает агентов в его панелях по выбранному маршруту |
Коротко о README
Сначала идут требования и пошаговая установка, затем формат конфигурации аккаунтов и таблица моделей с командами запуска. Дальше повседневные команды, фазы работы и заметки о безопасности и приватности.