Skip to main content

Command Palette

Search for a command to run...

CLI

Использование Agent в CLI

Режимы

CLI поддерживает те же режимы, что и Редактор. Переключаться между режимами можно с помощью slash-команд или флага --mode.

Режим Plan

Используйте режим Plan, чтобы продумать подход до начала работы с кодом. Agent задаёт уточняющие вопросы, чтобы уточнить ваш план.

  • Нажмите Shift+Tab, чтобы перейти в режим Plan
  • Используйте /plan, чтобы перейти в режим Plan
  • Запустите команду с флагом --plan или --mode=plan

Режим Ask

Используйте режим Ask, чтобы изучать код без внесения изменений. Agent ищет по вашей кодовой базе и отвечает на вопросы, не редактируя файлы.

  • Используйте /ask, чтобы переключиться в режим Ask
  • Запустите с флагом --mode=ask

Формулирование запросов

Для достижения наилучших результатов рекомендуется чётко формулировать задачу. Например, можно использовать промпт «не пиши код», чтобы Agent не изменял файлы. Это особенно полезно при планировании задач перед их выполнением.

Agent располагает инструментами для файловых операций, поиска, выполнения shell-команд и доступа к веб-ресурсам.

MCP

Agent поддерживает MCP (Model Context Protocol), обеспечивая расширенные возможности и интеграции. CLI автоматически обнаружит и учтёт конфигурационный файл mcp.json, позволяя использовать те же MCP‑серверы и инструменты, что настроены в редакторе.

ACP

Agent также поддерживает ACP (Agent Client Protocol) для интеграции с пользовательскими клиентами. Используйте agent acp, чтобы запустить CLI Cursor в качестве ACP-сервера через stdio с обменом сообщениями по JSON-RPC.

Правила

CLI-агент поддерживает ту же систему правил, что и Редактор. Вы можете создавать правила в каталоге .cursor/rules, чтобы предоставлять агенту контекст и инструкции. Эти правила автоматически загружаются и применяются в соответствии с их конфигурацией, позволяя настраивать поведение агента для разных частей проекта или определённых типов файлов.

Работа с Agent

Навигация

С помощью клавиши со стрелкой вверх (ArrowUpArrow Up) можно просматривать предыдущие сообщения по очереди.

Сочетания клавиш для ввода

  • Shift+Tab — Переключение между режимами (Agent, Plan, Ask)
  • Shift+Enter — Вставить новую строку вместо отправки — так удобнее писать многострочные промпты.
  • Ctrl+D — Выйти из CLI. Стандартное поведение shell: для выхода клавишу нужно нажать дважды.
  • Ctrl+J или +Enter — Универсальные сочетания для вставки новой строки, работающие во всех терминалах.

Ревью

Проверяйте изменения с помощью Ctrl+R. Нажмите i, чтобы добавить уточняющие инструкции. Используйте ArrowUpArrow Up/ArrowDownArrow Down для прокрутки, а ArrowLeftArrow Left/ArrowRightArrow Right — для переключения между файлами.

Выбор контекста

Выбирайте файлы и папки для добавления в контекст с помощью @. Чтобы освободить место в контекстном окне, выполните /summarize. /compress остаётся псевдонимом.

Передача диалога облачному агенту

Передайте диалог облачному агенту, чтобы он продолжал работу, пока вас нет. Добавьте & в начало сообщения, чтобы отправить его в облако. Продолжите работу в веб-версии или на мобильном устройстве на cursor.com/agents.

# Отправить задачу Cloud Agent прямо в ходе диалога& refactor the auth module and add comprehensive tests

Worktree в CLI

Передайте -w или --worktree [name], чтобы запустить Agent в новом Git worktree, а не напрямую редактировать текущую рабочую копию. Cursor создаёт эти рабочие копии в ~/.cursor/worktrees/<reponame>/<name> рядом с worktree, созданными в Редакторе. Если не указать name, Cursor сгенерирует его.

Cursor удаляет worktree CLI по тем же правилам хранения, что и worktree Редактора. Параметры и ограничения очистки см. в разделе Как очищаются старые worktree?.

Используйте --workspace <path> вместе с --worktree, если нужно явно указать корень репозитория. В противном случае CLI использует текущий рабочий каталог. --worktree изменяет только место, где Agent вносит изменения в файлы этого проекта.

# Создать временный worktree из текущего репозитория со сгенерированным именемagent --worktree "upgrade the test runner and fix any broken snapshots"# Создать worktree с заданным именем из другого репозиторияagent --workspace ~/src/my-app --worktree auth-fix "fix the flaky auth test and open a PR"

История

Продолжите существующий тред с помощью --resume [идентификатор треда], чтобы загрузить предыдущий контекст.

Чтобы возобновить последний диалог, используйте agent resume, --continue или slash-команду /resume.

Также можно выполнить agent ls, чтобы открыть предыдущие чаты и возобновить один из них.

Одобрение выполнения команд

Перед выполнением команд в Терминале CLI попросит вас подтвердить (y) или отклонить (n) их выполнение.

Неинтерактивный режим

Используйте -p или --print, чтобы запустить Agent в неинтерактивном режиме. Ответ будет выведен в консоль.

В неинтерактивном режиме Agent можно вызывать без взаимодействия с пользователем. Это позволяет интегрировать его в скрипты, CI-конвейеры и т. д.

В сочетании с --output-format можно управлять форматом выходных данных. Например, используйте --output-format json для структурированных выходных данных, которые проще обрабатывать в скриптах, или --output-format text для вывода финального ответа Agent в виде обычного текста.