Начало работы

Вариант A — только Datarim (по умолчанию)

Пользователь ответил «без Jev» → флаг --without-jev, выбранный им список --client и ответ --permissions.

Не передавайте его за пользователя: отсутствие ключа — не причина отказываться от Jev, защита работает без ключа.

Вариант B — Datarim и Jev на уровне проекта

Пользователь ответил «Jev для этого проекта» → флаг --with-jev, выбранный им список --client и ответ --permissions.

Хуки Jev регистрируются только в этом проекте и только для выбранных клиентов (.claude/settings.local.json, .codex/hooks.json, .cursor/hooks.json), и создаётся пустой файл ключа config/credentials/jev/api-key (права 0600). Не выбирайте этот вариант на машине, где уже стоит Jev для всей машины: сработают оба набора хуков. Используйте вариант C.

Вариант C — Jev на всю машину и Datarim в этом проекте

Пользователь ответил «Jev на всю машину» → флаги --with-jev --host-jev, список --client и ответ --permissions. Только в этом случае сначала поставьте Jev на машину:

# только если пользователь выбрал Jev на всю машину
python3 scripts/jev_host_install.py --client claude --client codex --client cursor \
  --datarim-project "$PROJECT" --dry-run
python3 scripts/jev_host_install.py --client claude --client codex --client cursor \
  --datarim-project "$PROJECT"

Jev для всей машины ставится один раз на пользователя и действует во всех каталогах, которые он открывает. Он пишет ~/.config/jev/, ~/.local/share/jev/, ~/.local/state/jev/, лаунчеры ~/.local/bin/{jev,jevclaude,jevcodex,jevcursor} (этот каталог должен быть в PATH) и добавляет свои хуки в пользовательскую конфигурацию каждого выбранного клиента, сохраняя все существующие хуки. --datarim-project заменяет список проектов с Datarim на машине: добавляя проект позже, перечислите все проекты заново. Файл ключа — ~/.config/jev/credentials/api-key.

Вариант D — Jev без Datarim

python3 scripts/jev_host_install.py --client claude --client codex --client cursor --dry-run
python3 scripts/jev_host_install.py --client claude --client codex --client cursor

Тот же установщик для машины, без --datarim-project и без установки в проект. Подробнее — Use Jev on its own.

Другие параметры установки

Установка из скрипта (CI)

Переключателя, который обходит токен ответов, нет. Конвейер с заранее проверенными ответами делает два шага: первый запуск отказывает и печатает токен в строке повторного запуска, второй передаёт этот токен с теми же ответами. Замените <flags> проверенными флагами-ответами, одинаковыми в обоих запусках:

out="$(./install.sh --project "$PROJECT" <flags> 2>&1)"
token="$(printf '%s\n' "$out" | sed -n 's/.*--answers \([0-9a-f][0-9a-f]*\) .*/\1/p' | tail -n 1)"
[ -n "$token" ] || { printf '%s\n' "$out" >&2; exit 1; }
./install.sh --project "$PROJECT" --answers "$token" <flags>

ИИ-агент, который ставит Datarim для человека, так не делает: он передаёт человеку вопросы, напечатанные первым запуском, и использует его ответы.

Отчёт после установки

После каждой установки или обновления установщик печатает строки отчёта внутри блока кода, перед которым стоит фраза «Copy the block below into your reply to the user unchanged (you may add your own text after it):». Агент копирует весь блок в свой ответ без изменений и без пересказа; свой текст он может добавить после блока. Строки в блоке:

• режим разрешений и файл, в котором он хранится: FULL_PERMISSIONS в каталоге состояния (есть файл — full, нет — ask; меняется командой jev permissions full|ask);
• при установке с Jev — путь к файлу ключа с пометкой, что пол безопасности Jev работает без ключа; ключ вставляется в редакторе, никогда не через echo или printf;
• never in .zshrc/.bashrc: JEV_* or DATARIM_* variables (e.g. JEV_PERMISSIONS) or the key; set them per shell or per launch — переменные JEV_* и DATARIM_* (например, JEV_PERMISSIONS) и ключ никогда не кладутся в .zshrc / .bashrc, а задаются для одной оболочки или одного запуска;
• если в проекте есть AGENTS.md: AGENTS.md is not modified by the installer (установщик не меняет AGENTS.md);
• при Codex с Jev — как одобрить хуки Codex; при Codex или Cursor — что .agents/skills/dr-* / .cursor/skills/dr-* — это команды /dr-*, упакованные для них, а не дополнительные скиллы фреймворка.

Куда положить ключ Jev

Откройте файл ключа вашей установки в редакторе, вставьте ключ одной строкой и сохраните. Файл уже создан с правами 0600 — не меняйте их. Установка с --with-jev печатает точный путь.

$EDITOR ~/.config/jev/credentials/api-key   # Jev на машину; в проекте: config/credentials/jev/api-key

• Один ключ на компьютер, общий для всех клиентов; на каждом компьютере — свой ключ.
• Никогда не записывайте ключ через echo или printf: команда останется в истории оболочки. Не кладите ключ в коммит, файл настроек или чат.
• export TYPESAFE_API_KEY=... не работает: лаунчеры и хуки удаляют эту переменную и читают только файл.
• При Jev на машину собственный файл ключа проекта остаётся пустым и не читается — так и должно быть.

Режим разрешений (только для лаунчеров Jev)

jev permissions          # показать текущий режим
jev permissions full     # лаунчеры jev* запускают клиентов без запросов разрешений
jev permissions ask      # вернуть запросы самого клиента (по умолчанию)

full добавляет --dangerously-skip-permissions (Claude Code), --dangerously-bypass-approvals-and-sandbox (Codex) или --force --approve-mcps (Cursor) к запускам через jev, jevclaude, jevcodex, jevcursor, если вы не передали свой параметр разрешений. Ответ установщику --permissions ask|full задаёт тот же переключатель. Режим хранится для проекта (установка в проект) или для машины (Jev на машину). Пол безопасности работает и в режиме full. Прямой запуск claude, codex или cursor-agent это не меняет. jev off / jev on останавливают и возобновляют обращения к API; пол безопасности работает в обоих случаях.

Настройки и секреты

Ничего из этого не коммитится: пути проекта скрыты через .git/info/exclude, пути машины лежат в домашнем каталоге. Переменные окружения из таблицы задаются для одной оболочки или одного запуска, никогда не в .zshrc, .bashrc или другом файле запуска: например, JEV_PERMISSIONS=full там отключил бы запросы разрешений для каждого запуска через jev*. У постоянных настроек есть свои переключатели: jev permissions, jev on / jev off и файл настроек. Какой код читает каждую настройку — в INSTALL.md.

Задаются точками входа, не вручную: DATARIM_RUNTIME (через source .datarim-runtime/activate.sh, вместе с PATH), а также DATARIM_ROOT, DATARIM_PROJECT_ROOT, DATARIM_JEV_CONFIG, DATARIM_JEV_HOME, DATARIM_JEV_STATE, TYPESAFE_API_KEY_FILE, JEV_STATE_DIR, JEV_HOST_STATE (через jev* и хуки). Ключи провайдеров моделей (ANTHROPIC_API_KEY, OPENAI_API_KEY и подобные) не читают ни установщик, ни команды Datarim, ни Jev; клиенты авторизуются сами.

Проверки без ключа

Пол безопасности, если Jev установлен. Запускайте в проекте; разрушительная команда — лишь текст внутри JSON, ничего не выполняется:

printf '{"tool_name":"Bash","tool_input":{"command":"rm -rf /"},"cwd":"%s","session_id":"check"}' "$PWD" \
  | python3 .datarim-runtime/scripts/jev_hook.py claude PreToolUse      # Jev в проекте
# Jev на машину: подайте тот же JSON в  ~/.local/share/jev/bin/jev-hook claude PreToolUse

Ожидается: "permissionDecision": "deny" с причиной Jev deterministic safety floor: recursive delete of a protected path.

jev doctor отвечает за Jev (клиенты, регистрация хуков, файл ключа, область, доверие Codex, доставка хуков); datarim-doctor.sh и /dr-doctor — только за структуру файлов задач в datarim/.