Установка

Установите десктопное приложение Cusp или CLI cusp в macOS, Windows или Linux.

Cusp поставляется как десктопное приложение и как инструмент командной строки. Оба используют одну и ту же среду выполнения, так что можно установить любой из них или оба сразу. Сессии, начатые в одном, видны в другом, если у них общий каталог данных.

Cusp 0.1 — предварительная версия. До 1.0 установщики и названия пакетов могут измениться. Если что-то здесь не совпадает с тем, что вы видите, загляните в раздел «Что нового».

Десктопное приложение

Скачайте установщик для своей платформы на cusp.run/download. Первые выпуски — для macOS; установщики для Windows и Linux появятся в одном из следующих выпусков.

  1. Скачайте Cusp-universal.dmg. Это универсальная сборка для Mac на Apple silicon и Intel.
  2. Откройте образ диска и перетащите Cusp в папку Программы.
  3. Откройте Терминал и один раз выполните: 
    xattr -dr com.apple.quarantine /Applications/Cusp.app
  4. Запустите Cusp из папки «Программы» или через Spotlight.

Эта предварительная версия ещё не прошла нотаризацию Apple. macOS не открывает скачанное из интернета приложение, пока с него не снят флаг карантина, а шаг 3 снимает его только с Cusp. Обновления устанавливаются без этого шага. Нотаризованные сборки появятся в одном из следующих выпусков.

Закрытие окна скрывает Cusp; вернуть его можно значком в Dock. Чтобы выйти, нажмите ⌘Q.

Что устанавливает десктопное приложение

  • Cusp — нативная оболочка. В ней работает интерфейс рабочей области, а также строка меню, значок в трее, уведомления, диплинки и связка ключей.
  • cusp-daemon — среда выполнения агента, sidecar рядом с основным исполняемым файлом. Приложение запускает его, проверяет его состояние каждые 10 секунд и перезапускает, если он перестал отвечать. Он завершается вместе с приложением.

Десктопное приложение хранит данные в системной папке данных приложений. В macOS это ~/Library/Application Support/run.cusp.desktop/.

CLI

Команда cusp даёт интерактивный терминальный интерфейс и неинтерактивный режим для скриптов.

Будет доступно с первым публичным релизом.

По умолчанию CLI хранит сессии, контрольные точки файлов и worktree в ~/.cusp. Чтобы хранить их в другом месте, используйте --data-dir или переменную окружения CUSP_DATA_DIR.

Веб-приложение

Веб-приложение скоро появится. Оно будет запускать сессии в облачных песочницах и позволит управлять демоном на вашем компьютере из браузера или с телефона.

Системные требования

Минимум
macOSmacOS 12 Monterey или новее, Apple silicon или Intel
WindowsWindows 10 или 11, x64, с WebView2
Linuxx86_64, дистрибутив на базе glibc с WebKitGTK 4.1 (только для десктопного приложения)
CLImacOS (Apple silicon или Intel), Linux с glibc (x64 или arm64), Windows x64; Node.js 18+, если устанавливаете через npm
СетьДоступ хотя бы к одному провайдеру моделей или к локальному серверу моделей

Необязательные инструменты, с которыми агент работает лучше:

  • Git. Нужен для изоляции в worktree (отдельная рабочая копия), диффов и /review.
  • ripgrep (rg). Инструмент Grep использует его, если он установлен, а иначе переключается на встроенный движок с идентичным выводом.
  • Языковые серверы. tsc или tsgo для TypeScript и любой установленный у вас языковой сервер с stdio-интерфейсом дают диагностику после правок.
  • bubblewrap (bwrap) в Linux. Песочница включена по умолчанию, и без bwrap Cusp отказывается выполнять команды оболочки, а не запускает их вне песочницы. В macOS используется встроенная песочница Seatbelt. См. Песочница.

Обновление

Десктопное приложение будет обновляться само из подписанных релизов, когда обновления включат для публичных сборок. До тех пор скачайте новую версию и замените приложение. Чтобы обновить CLI, выполните его команду установки ещё раз или обновите через пакетный менеджер, которым вы его установили.

Удаление

  • macOS: завершите Cusp и перенесите его из папки «Программы» в Корзину. Чтобы удалить всё, что он сохранил, удалите также:
    • ~/Library/Application Support/run.cusp.desktop/: настройки, сессии и данные демона (daemon/)
    • ~/Library/Logs/run.cusp.desktop/: журналы и записи о сбоях
    • ~/Library/Caches/run.cusp.desktop/ и ~/Library/WebKit/run.cusp.desktop/: кеши веб-представления
    • ~/Library/LaunchAgents/Cusp.plist: есть, только если вы включили Открывать при входе
  • Windows: откройте Параметры → Приложения → Установленные приложения.
  • Linux: удалите пакет менеджером пакетов или удалите файл AppImage.
  • CLI: удалите ~/.cusp/bin (скрипт-установщик) или удалите его пакетным менеджером, которым вы его установили. Чтобы удалить сессии, контрольные точки и пользовательские настройки, удалите ~/.cusp.

Ключи провайдеров, сохранённые десктопным приложением, хранятся в системной связке ключей под службой run.cusp.desktop (run.cusp.desktop.dev для сборок, которые вы собрали сами). Удалить их можно в приложении «Связка ключей», в диспетчере учётных данных Windows или в связке ключей Secret Service.

Что дальше

Введение

Cusp — агентная среда разработки для любой модели, настроенная под каждую.

Быстрый старт

Начните первую сессию Cusp — в десктопном приложении или в терминале.

На этой странице

Десктопное приложениеЧто устанавливает десктопное приложениеCLIВеб-приложениеСистемные требованияОбновлениеУдалениеЧто дальше