setup
Plan or apply first-run Vigil configuration setup.
Syntax#
vigil setup [args]
Options#
| Flag | Description |
|---|
--json | Emit the versioned JSON envelope. |
--profile | Select or override the detected profile. |
--write | Apply reviewed setup changes. |
--force | Replace an existing configuration after review. |
--yes | Accept deterministic setup defaults. |
--dry-run | Preview setup without writing. |
--stream | Stream phase status as text or JSONL in non-interactive setup. |
--verbose | Stream additional phase details. |
Examples#
vigil setup
vigil setup --json
Example Use Cases#
- Use this command when you need to plan or apply first-run Vigil configuration setup.
- Preview or review the operation before allowing repository changes.
Technical Contract#
| Binding | builtin:setup |
|---|
| Stability | stable |
|---|
| Timeout | 2m0s |
|---|
| Required tools | None |
|---|
| Capabilities | filesystem:read, filesystem:write, interactive |
|---|
| Output formats | text, json |
|---|