<!-- Canonical page: https://docs.radforge.dev/setup/init/ -->

# rad init

Run initialization from the repository you want Radforge to analyze.

```bash
rad init --dry-run
rad init
```

The command checks project files for supported TypeScript and Python setups. It can install required packages, add `.radforge/` to `.gitignore`, and install the bundled Radforge agent skill. It does not submit a mutation run.

Use `--language typescript` or `--language python` when Radforge cannot choose a language. `--language mixed` prepares both, but each hosted run must contain only TypeScript/JavaScript or only Python sources.

Use `--target repo`, `--target user`, or `--target both` to choose where the coding-agent skills are installed. `repo` writes to `.agents/skills/radforge/` and `.claude/skills/radforge/`. `user` writes to the same directories under your home directory.

`--dry-run` shows changes without writing files. `--yes` skips prompts only when Radforge selects exactly one supported setup. Use `--json` for scripts, and review package and file changes before committing them.
