reach init

Scaffold a new Reach project configuration and initialize skill directories.

---

Synopsis

reach init [OPTIONS]

---

Behavior

1. Detects or creates standard skill directory locations (.agents/skills/).
2. Detects available agent CLI binaries and environment variables to choose an appropriate default runtime.
3. Generates a tailored reach.toml file with sensible defaults.
4. Creates .reach/ workspace cache directory for local query sets and artifacts.

---

Key Scenarios

Initialize with auto-detectionSpecify a default agent runtimeCustom skills directoryForce overwrite

Scaffold a project detecting local skills and available agent CLI:

reach init

Explicitly set the default agent driver:

reach init --agent claude-code
reach init --agent antigravity-cli

Configure an explicit skill path:

reach init --skills ./custom-skills

Overwrite an existing reach.toml:

reach init --force

---

Options

Option	Type	Default	Description
--agent	TEXT	Auto-detected	Default agent runtime to configure in reach.toml.
--skills, -s	PATH	.agents/skills	Directory path where skills are stored.
--force, -f	flag	false	Overwrite existing reach.toml configuration if present.
--quiet, -q	flag	false	Suppress summary output.