CLI

cusp [options] [prompt]

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

ПримерыСкопировать ссылку на раздел

cusp                                     # interactive session in this folder
cusp "explain the build pipeline"        # start with a prompt
cusp -c                                  # continue the most recent session here
cusp -r                                  # pick a session to resume
cusp -m openai:gpt-6.1-sol --effort high # choose model and effort
cusp -p "list TODO comments in src/"     # headless: print the answer and exit
cat error.log | cusp -p "what failed?"   # headless with piped input

ПараметрыСкопировать ссылку на раздел

СессияСкопировать ссылку на раздел

--continue и --resume нельзя использовать вместе. --fork-session требует одного из них.

Модель и разрешенияСкопировать ссылку на раздел

--allowedTools и --disallowedTools также принимают написание в kebab-case: --allowed-tools и --disallowed-tools. Элементы списка можно разделять запятыми или пробелами; внутри скобок Cusp список никогда не делит, поэтому "Bash(git log *),Edit" — это два правила. Имя режима manual принимается как синоним default.

Неинтерактивный режимСкопировать ссылку на раздел

--output-format и --input-format требуют -p. С -p нельзя открыть выбор сессии, поэтому в неинтерактивном режиме --resume требует явного id.

ДемонСкопировать ссылку на раздел

ПрочееСкопировать ссылку на раздел

Коды завершенияСкопировать ссылку на раздел

Работа в неинтерактивном режимеСкопировать ссылку на раздел

cusp -p выполняет один запрос и завершается. Запрос берётся из аргументов, из stdin или из обоих источников: входные данные из конвейера читаются, когда stdin не является терминалом.

В неинтерактивном режиме отвечать на вопросы некому, поэтому:

• Запросы разрешений решаются через --allowedTools и --disallowedTools. Всё, что не разрешено заранее, запрещается, и агенту сообщается, как действовать дальше. Каждый отказ попадает в permission_denials в JSON-результате.
• На вопросы агента (AskUserQuestion) приходит ответ «No answer: running non-interactively. Use your best judgment and state the assumption.»
• Запросы на доверие к рабочей области не показываются.

# Allow tests and edits, nothing else
cusp -p "make the failing test in auth.test.ts pass" \
  --allowedTools "Bash(bun test *)" Edit Write \
  --max-turns 25 \
  --output-format json

Вывод textСкопировать ссылку на раздел

Последнее сообщение ассистента обычным текстом. Ошибки выводятся в stderr.

Вывод jsonСкопировать ссылку на раздел

Один JSON-объект по завершении запуска. Имена полей следуют распространённому формату результата неинтерактивного режима (type, subtype, result, session_id, total_cost_usd, …), поэтому существующие скрипты, которые его разбирают, продолжат работать.

{
  "type": "result",
  "subtype": "success",
  "is_error": false,
  "result": "Fixed the token expiry check in src/auth/session.ts. All 48 tests pass.",
  "session_id": "ses_01JCQ8Z4X9T5V2M3N7K1P6R0WA",
  "num_turns": 7,
  "duration_ms": 41873,
  "total_cost_usd": 0.0871,
  "usage": {
    "input_tokens": 182340,
    "output_tokens": 2911,
    "reasoning_tokens": 1404,
    "cache_read_input_tokens": 151200,
    "cache_creation_input_tokens": 18420
  },
  "permission_denials": []
}

Вывод stream-jsonСкопировать ссылку на раздел

Пока запуск идёт — по одному JSON-объекту на строку, а в последней строке — тот же объект результата, что и в json.

Первая строка описывает запуск:

{"type":"system","subtype":"init","session_id":"ses_01JC…","cwd":"/Users/me/code/app","model":{"providerId":"anthropic","modelId":"claude-opus-5-5"},"permission_mode":"default","cusp_version":"0.1.0","daemon":"spawned"}

Каждая следующая строка содержит одно событие сессии:

{"type":"event","session_id":"ses_01JC…","event":{"seq":12,"body":{"type":"tool.start", …}}}

Потоковые дельты (assistant.delta, tool.progress) включаются только с --include-partial-messages.

Ввод stream-jsonСкопировать ссылку на раздел

С --input-format stream-json каждая строка в stdin — это сообщение пользователя:

{"type":"user","message":{"role":"user","content":"Now add tests for it."}}

content может быть строкой или массивом блоков содержимого ({"type":"text","text":"…"}, изображения и так далее). Так другая программа может вести с Cusp многоходовой диалог через конвейер.

Интерактивный режимСкопировать ссылку на раздел

Слеш-командыСкопировать ссылку на раздел

Навыки, которые можно вызвать, появляются в том же меню /.

Префиксы в запросеСкопировать ссылку на раздел

Горячие клавиши перечислены в разделе Горячие клавиши.

Переменные окруженияСкопировать ссылку на раздел