Введение
Cusp — агентная среда разработки для любой модели, настроенная под каждую.
Cusp — агентная среда разработки для любой модели. Вы указываете папку, ставите задачу, и агент читает код, правит файлы, запускает команды и сам проверяет результат. Всё это — с выбранной вами моделью: Claude, GPT, Gemini, Grok, DeepSeek, Kimi, GLM, Qwen, MiniMax, Mistral или любой другой за шлюзом вроде OpenRouter, Vercel AI Gateway или LiteLLM. Локальные модели через Ollama или LM Studio тоже подойдут.
Если вы уже работаете с агентом для кода, перенесите свои настройки. Cusp читает AGENTS.md, CLAUDE.md и GEMINI.md, настройки .claude/, навыки, субагентов, хуки и MCP-серверы на месте, а остальное импортирует из агентов, с которыми вы уже работаете. См. Импорт вашей настройки.
Cusp — ранняя предварительная версия (0.1). В репозитории уже есть среда выполнения, harness, провайдеры, CLI, десктопная оболочка и локальная Команда. Веб-приложение, облачная синхронизация и облачные команды агентов ещё в разработке, и в документации эти части помечены как предварительная версия или «скоро».
Чем он отличается
Любая модель, один агент. Один и тот же цикл агента, инструменты, разрешения и точки расширения работают у всех провайдеров. Переключайте модель посреди сессии командой /model и продолжайте работу.
Harness, который подстраивается под модель. Harness — обвязка вокруг модели. Модели обучены на разных «диалектах» инструментов. Cusp даёт моделям семейства GPT apply_patch, Claude и Gemini — Edit в стиле str_replace, а слабым или локальным моделям — правки строк с привязкой по хешу. Он воспроизводит состояние рассуждений так, как этого ждёт каждый провайдер, поэтому рассуждения модели сохраняются от хода к ходу. Почему это важно, объясняется в статье о harness.
Вставьте ключ. Cusp определит провайдера по ключу или базовому URL, проверит, какие протоколы отвечают (не тратя токены), получит список моделей и выберет сильную основную модель, а также небольшую быструю — для заголовков и сводок.
Ваши настройки работают. Инструкции, навыки, субагенты, хуки и MCP-серверы работают как есть: AGENTS.md, CLAUDE.md, GEMINI.md, .claude/skills, .claude/agents, хуки с их JSON-протоколом и правила вроде Bash(npm run test:*). См. Импорт вашей настройки.
Осторожность по умолчанию. Каждый вызов инструмента перед выполнением проходит через хуки и движок разрешений. Запись в конфигурацию агента, в .git и в файлы запуска оболочки требует подтверждения человека в любом режиме. Команды оболочки выполняются в песочнице операционной системы (Seatbelt в macOS, bubblewrap в Linux) без доступа к сети, если вы его не разрешили.
Интерфейсы
У Cusp одна среда выполнения и несколько способов с ней работать.
| Интерфейс | Что это | Статус |
|---|---|---|
CLI (cusp) | Интерактивный терминальный интерфейс и неинтерактивный режим -p для скриптов и CI | Превью |
| Десктопное приложение | Нативное приложение для macOS, Windows и Linux (Tauri 2): само запускает демон и хранит ключи в системной связке ключей | Превью |
| Веб-приложение | Та же рабочая область в браузере — для облачных песочниц и удалённого управления вашим компьютером | Скоро |
| Редакторы | Расширение для VS Code, а также IDE JetBrains, Zed и другие ACP-редакторы через cusp acp | Превью |
| Agent SDK и GitHub Action | Запуск Cusp из TypeScript или Python либо по упоминаниям @cusp в GitHub | Превью |
| Команда | ИИ-коллеги с ролью, расписанием, бюджетом и подтверждениями с запретом по умолчанию. Сейчас локально, облачная версия — скоро | Превью |
Как это устроено
Все интерфейсы обращаются к одной и той же среде выполнения агента — демону (daemon). Сами интерфейсы никогда не вызывают модель.
- Демон работает на вашем компьютере. Десктопное приложение запускает его как sidecar-процесс; CLI подключается к уже запущенному или запускает свой. Он слушает только
127.0.0.1на случайном порту и требует в каждом запросе bearer-токен, который создаётся при каждом запуске. - Сессия — журнал типизированных событий, в который можно только дописывать: ваши сообщения, ответы модели, каждый вызов инструмента и его результат, запросы разрешений и решения по ним, контрольные точки. Интерфейс — лишь отображение этого журнала, поэтому сессии можно возобновлять, ветвить и откатывать. См. Сессии.
- Harness выполняет цикл. Он собирает контекст (инструкции, память, инструменты), получает потоковый ответ модели и выполняет вызовы инструментов. Каждый вызов проходит через хуки
PreToolUse, затем движок разрешений, затем сам инструмент, затем хукиPostToolUse. Вызовы только для чтения из одного пакета выполняются параллельно. - Слой провайдеров переводит нормализованный формат сообщений Cusp в протокол, на котором говорит конечная точка, и обратно: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages или Google Gemini. Он отвечает за повторные попытки, резервные варианты, кеширование промптов и учёт расходов.
- Ваши файлы сохраняются в снимок перед запуском каждого изменяющего инструмента, чтобы откат мог их восстановить.
Desktop app ─┐
CLI ─────────┼── REST + WebSocket (127.0.0.1, bearer token) ──► daemon
Web app ─────┘ │
harness: tools · permissions · hooks · MCP
│
providers: OpenAI · Anthropic · Gemini · gatewaysЧто дальше
Установка Cusp
Десктопное приложение, CLI и системные требования.
Быстрый старт
Первая сессия — в десктопном приложении или в терминале.
Импорт вашей настройки
Что Cusp читает и импортирует из агентов, с которыми вы уже работаете.
Провайдеры и шлюзы
Все поддерживаемые провайдеры, протоколы и шлюзы.
Разрешения
Режимы, правила и защищённые пути.
Справочник CLI
Все команды, флаги и коды выхода.