| Flag | Description |
|---|---|
--absolute-git-hook-path | Embed full binary path in Git hooks. Required for GUI Git clients that don’t source shell profiles. See GUI Git Clients. |
--agent NAME | Agent to setup hooks for: claude-code, codex, gemini, opencode, cursor, copilot-cli, factoryai-droid, or pi. Enables non-interactive mode. |
--checkpoint-remote PROVIDER:OWNER/REPO | Push checkpoint branches to a separate repository (e.g., github:org/checkpoints-private). See Checkpoint Remote. |
-f, --force | Force reinstall hooks (removes existing Entire hooks first) |
--local | Write settings to .entire/settings.local.json instead of .entire/settings.json. |
--project | Write settings to .entire/settings.json even if it already exists |
--skip-push-sessions | Disable automatic pushing of session logs on Git push |
--telemetry | Enable anonymous usage analytics (default: true) |
-y, --yes | Accept defaults without prompting. Useful for automation, CI, and bootstrap flows. |
--yes for non-interactive setup flows:
--yes is not just a confirmation bypass. It runs entire enable non-interactively with default choices. On a fresh repository, it enables the default setup without prompts. On an already configured repository, it follows the setup-management path. Outside a Git repository, it also accepts the bootstrap defaults to initialize Git, create a private GitHub repository through gh, and create the initial commit.
Important behavior:
- If you also pass
--agent NAME, that explicit agent selection takes precedence over the default multi-agent behavior. - If you pass
--telemetry=false, or setENTIRE_TELEMETRY_OPTOUT, that explicit telemetry opt-out still overrides the--yesdefault.
The
--local and --project flags control which Entire settings file is modified. Entire always modifies the agent’s project settings (e.g., .claude/settings.json, .gemini/settings.json, .opencode/plugins/entire.ts, .factory/settings.json, or .pi/extensions/entire/index.ts).