Руководство по Cursor Origin: установка CLI, зеркалирование GitHub и pull request’ы

Что такое Cursor Origin?

Cursor Origin — это Git‑форж. Он размещает репозитории, зеркалирует проекты GitHub и поддерживает pull request’ы и просмотр кода. Репозитории Origin также работают с облачными агентами и автоматизациями Cursor.

Чем Cursor Origin отличается от GitHub?

Origin не покрывает все возможности GitHub. Публичные репозитории не документированы, а в зеркала не попадают GitHub Issues, воркфлоу GitHub Actions и Actions secrets. GitHub остаётся более широкой платформой для публичных репозиториев, Issues, Actions и сторонних приложений, поэтому сегодня Origin — это более узкий сервис.

Основное отличие находится под привычным Git‑процессом: Cursor создал отдельный слой хранения для объёма веток и коммитов, создаваемого агентами. Cursor называет этот фокус «масштаб агентов»: сценарии, в которых многие агенты ветвятся, коммитят и открывают pull request’ы в один и тот же репозиторий.

Почему Cursor построил собственный Git‑хост?

Архитектура хранилища объясняет, почему Cursor создал новый Git‑хост, а не добавил ещё один интерфейс к существующему.

Инженерный пост Cursor о Continuity описывает, что существующие Git‑хосты держат репозиторий на нескольких серверах и принимают пуш после согласия большинства. Cursor утверждает, что эта модель дороже, когда в системе тысячи краткоживущих репозиториев или частые пуши в один репозиторий.

Как работает хранилище Continuity в Cursor Origin?

Continuity, или «Cnt», — это система хранения за Origin. Она записывает журнал предзаписи (write-ahead log) в S3‑совместимое объектное хранилище как источник истины. Локальный Git‑репозиторий на диске — это тёплый кэш, который можно восстановить из журнала.

Continuity хранит Git‑записи как объекты. Изображение автора.

Поскольку объектный журнал — это реальная запись, Cursor может добавлять реплики для чтения для нагруженных репозиториев и убирать их при снижении спроса. В тестах Cursor пропускная способность чтения росла с добавлением реплик, до 100 реплик. Система выдерживала до 120 пушей в секунду на стандартном S3, но эти цифры не проверены независимым бенчмарком.

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

Кто может получить доступ к Cursor Origin?

Origin доступен на планах Pro, Teams и Enterprise, но не на бесплатных. Доступ разворачивается поэтапно, поэтому подходящий план не гарантирует мгновенное появление вкладки Codebase. В Pro вы владеете индивидуальным неймспейсом и закрепляете имя собственного кодобейса.

Администраторы Enterprise могут отключить его для организации. В обзоре Cursor сказано, что любой член команды может закрепить первое имя кодобейса, тогда как на странице Codebase Settings указано, что это должен сделать администратор команды. Уточните это право в своей команде перед настройкой.

Что такое Cursor Origin CLI?

Origin поставляется с собственной утилитой командной строки для аутентификации, работы с репозиториями, pull request’ами и конфигурации аккаунта.

Cursor Origin CLI и Cursor Agent CLI

CLI Origin — это отдельный бинарник, origin, от Agent CLI Cursor, который запускается как agent. 

Мне было легко перепутать названия, потому что origin — это также общепринятое имя для Git‑удалённого. В этой статье «push в origin» означает Git‑удалённый, а «запустить origin» — CLI.

Какие платформы поддерживают Origin CLI?

Cursor документирует macOS, Linux и Windows через WSL. На момент моего теста Windows означала WSL, так как родного установщика не было.

Если вы работаете в Windows, перед установкой CLI откройте терминал Ubuntu. Запуск установочного скрипта оболочки в PowerShell — это уже другая настройка.

Команды Cursor Origin CLI

В Cursor Origin CLI сейчас девять групп команд.

Большинство команд репозитория берут цель из Git‑удалённого с именем origin. Опция -R owner/repo задаёт цель напрямую — это полезно в скриптах, которые могут работать с несколькими репозиториями. Команды ruleset только показывают существующие правила пуша и слияния; они их не меняют.

Как установить и войти в Cursor Origin CLI

Cursor предоставляет CLI через shell‑скрипт, а не менеджер пакетов. Команда берётся со страницы установки Cursor.

Как установить Cursor Origin CLI

Установка сводится к одной строке:

curl -fsSL https://downloads.cursor.com/origin/install.sh | sh

Установщик поместил origin в ~/.local/bin/origin. Если ваша команда проверяет установочные скрипты перед запуском, сначала скачайте скрипт вместо того, чтобы сразу передавать его в sh.

Исправление ошибки Origin CLI «command not found»

Если оболочка не находит origin после установки, добавьте его каталог в PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Замените ~/.zshrc на ~/.bashrc в bash. Это одноразовое исправление на каждой машине.

Проверка установки и входа

Выполните origin --version и origin --help для подтверждения установки, затем используйте origin auth login, чтобы открыть браузерную авторизацию Cursor.

Вот как выглядел вывод проверки в WSL:

Версия и справка Origin CLI. Изображение автора.

В безголовой среде CLI печатает URL. Логин также настраивает помощник учётных данных Git, поэтому Origin‑удалённые работают без отдельного токена Git. Затем выполните origin auth status, чтобы проверить сессию.

Использование API‑ключа Cursor без браузера

Для CI или скриптов выполните origin auth login --api-key <key> или задайте CURSOR_API_KEY перед origin auth login. Держите ключ вне коммитов. CURSOR_AUTH_TOKEN отличается и ожидает bearer‑токен.

Как создать, клонировать и запушить репозиторий Cursor Origin

После входа вы можете создать репозиторий на веб‑странице или через CLI. Отправка выполняется стандартными командами Git.

Создание репозитория с помощью origin repo create

На cursor.com/codebase выберите New, введите имя и выберите видимость Internal или Private. 

В CLI origin repo create my-project использует неймспейс вашего аккаунта. Добавьте владельца, как в origin repo create acme/my-project, для командного неймспейса. Необязательный флаг --default-branch меняет серверное значение по умолчанию main.

Команда origin repo clone acme/my-project клонирует репозиторий по HTTPS с логином, сохранённым CLI.

Первый пуш в Origin

После первого пуша репозиторий появится в Codebase:

Репозиторий запушен и отображён в Codebase. Видео автора.

Для совершенно пустого нового репозитория клонируйте его, добавьте файл и выполните пуш:

git clone https://origin.cursor.com/{owner}/{repo}.git
cd {repo}
echo "# {repo}" > README.md
git add .
git commit -m "Initial commit"
git push -u origin main

Если Git сообщает об ошибке прав .git/config.lock под /mnt в WSL, вместо этого клонируйте под ~ . Это исправило ошибку в моём тесте.

После пуша откройте Codebase и проверьте, что коммит появился. Вкладка Code показывает дерево файлов и историю коммитов. Нажмите T для Go to file или используйте поле поиска для поиска по коду.

Пуш существующего Git‑репозитория в Origin

Если у вас уже есть проект с историей Git, сначала выполните git remote -v. Команда ниже применима только когда у репозитория ещё нет удалённого с именем origin:

git remote add origin https://origin.cursor.com/{owner}/{repo}.git
git push -u origin main

Если origin уже указывает на GitHub, используйте другое имя удалённого, например cursor, вместо замены существующего URL. Команды Origin CLI не будут выводить репозиторий из этого имени, поэтому передавайте -R owner/repo при их запуске.

Как зеркалировать репозиторий GitHub в Cursor Origin

Зеркало копирует существующий проект GitHub в Origin и поддерживает связь между сервисами.

Требования к зеркалированию GitHub в Cursor Origin

Вам понадобятся доступ к Origin, приложение Cursor GitHub, подключённое к организации или аккаунту — владельцу репозитория, и административный доступ к этому репозиторию на GitHub. Прав доступа на запись недостаточно.

Запуск зеркала GitHub в Cursor Origin

На cursor.com/codebase выберите Sync from GitHub, укажите организацию и репозиторий и подтвердите. Альтернатива в CLI — origin repo create-mirrored owner/repo, описано в документации по зеркалированию.

Что зеркалирует Cursor Origin из GitHub

Origin зеркалирует данные Git, но не каждую функцию GitHub:

GitHub Actions продолжают выполняться на GitHub. Интеграции Depot и Buildkite применимы к репозиториям, размещённым в Origin, а не к зеркальным копиям.

Когда GitHub остаётся источником истины

Пока репозиторий зеркалируется, пуши через Origin проходят на GitHub. Detach from GitHub в настройках репозитория делает копию Origin автономной, не меняя репозиторий на GitHub.

Как открыть и проверить pull request в Cursor Origin

Pull request’ы в Origin используют ту же последовательность ветка → пуш → ревью, что и на других Git‑хостах. Наш гайд по работе с pull request’ами описывает эту последовательность.

Создание ветки и отправка изменения

Создайте и запушьте рабочую ветку:

git checkout -b my-change
echo "Example change" >> README.md
git add README.md
git commit -m "Add example change"
git push -u origin my-change

Git сделал свою часть; следующая команда — для Origin.

Открытие pull request через Origin CLI

Команды репозитория выводят цель из Git‑удалённого с именем origin. Выполните origin pr create или передайте -R owner/repo, чтобы задать репозиторий напрямую. По умолчанию команда создаёт черновик; передайте --status open, если PR готов к ревью.

Ревью pull request в Cursor Origin

CLI включает origin pr list, origin pr view, origin pr diff и origin pr checks. Без настроенного CI‑приложения origin pr checks вывел No checks reported. и завершился с кодом 1 в моём тесте.

Этот код возврата важен в shell‑скриптах с set -e, так как пустая вкладка Checks может остановить скрипт, хотя сам pull request в порядке.

Ревью pull request с четырьмя вкладками. Изображение автора.

В веб‑интерфейсе у каждого pull request четыре вкладки: Activity, Commits, Checks и Files Changed, плюс запросы ревьюеров, встроенные комментарии и кнопка слияния. Веб‑страница показывает конфликты слияния, а origin pr status --conflict-status сообщает о них в терминале.

В терминале также доступна origin pr merge. PR, созданные в репозитории, размещённом на Origin, остаются в Origin, а активность в зеркальном репозитории отправляется обратно в GitHub.

Доступ команды и права репозиториев в Cursor Origin

Права Origin существуют на уровнях кодобейса и репозитория.

Настройки Codebase и настройки репозитория

Настройки Codebase — для всей команды: кто может включить Origin, создавать репозитории и устанавливать приложения. Настройки репозитория относятся к одному репозиторию и охватывают разделы General, Permissions, Rules и Protections, а также Apps, хотя в документации Cursor предупреждают, что разделы Permissions и Rules перерабатываются.

Если коллега может пользоваться Origin, но не может открыть какой‑то репозиторий, проверьте права именно этого репозитория, а не общекомандные настройки.

Внутренние и приватные репозитории

Есть два вида репозиториев с ограниченным доступом:

• Internal репозитории видны членам команды с доступом к кодобейсу. 
• Private репозитории видны только участникам, которым доступ выдан напрямую или через права кодобейса. Переключение репозитория в режим private оставляет сделавшего изменение администратором.

Как проверить доступ к репозиторию Cursor Origin

Команда origin repo list показывает все репозитории, видимые текущему аккаунту. Чтобы посмотреть, кто имеет доступ к одному репозиторию, откройте Settings, затем Permissions.

Лучшие практики Cursor Origin

Три важных момента при работе с Origin:

• Перед удалением или перенастройкой репозитория подтвердите полный owner/repo и проверьте его удалённые. 

• Избегайте -y, пока цель не проверена. 

• Страницы прав в Cursor противоречат друг другу, поэтому перед автоматизацией изменений доступа сверяйтесь с актуальной документацией.

Cursor Origin и GitHub: сравнение возможностей

Origin завязан на рабочие процессы агентов Cursor, тогда как GitHub охватывает более широкую экосистему репозиториев.

Git‑хостинг, pull request’ы и CI/CD

Чтобы не повторять разделы, вот краткая версия разделения возможностей:

Строка про агентов — та, что требует контекста.

Cursor Origin и GitHub для рабочих процессов агентов

Обе платформы позволяют агентам работать с репозиториями. Origin держит этот цикл внутри Cursor; GitHub предлагает его через панель Agents и инструменты Copilot, включая общедоступный CLI.

Когда использовать Cursor Origin, GitHub или оба

• Используйте Origin, когда репозиторий internal или private, большая часть работы агентов и так происходит в Cursor, а ваш деплой или CI могут работать через Vercel, Depot или Buildkite.
• Оставьте GitHub основным хостингом, когда проект публичный, Issues и Actions — часть ежедневного процесса, или команда зависит от маркетплейса GitHub.
• Используйте оба, когда вам нужен просмотр кода и рабочие процессы агентов Origin без переноса исходного репозитория. Зеркало сохраняет пуши и активность pull request’ов привязанными к GitHub, делая тот же код доступным в Origin.

Итоги

Я прошёл путь от свежей установки WSL до открытого pull request в Origin, используя тот же поток ветка → коммит → пуш, что и на GitHub. CLI не менял работу Git; отличия Origin проявились вокруг хостинга, прав и зеркалирования.

После использования я бы относился к Origin как к дополнению к GitHub, а не полной замене. Зеркалирование — самый практичный вход для существующего репозитория, потому что GitHub может оставаться авторитетным источником. Публичным проектам и процессам, сильно зависящим от Actions, пока мало причин переезжать.

Для дальнейшего чтения наш гайд по Cursor Automations охватывает задачи агентов, которые работают с существующим репозиторием. Наше руководство что такое GitHub и как им пользоваться подробнее объясняет рабочий процесс GitHub.