You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
`codex --full-auto` is the recommended default once this wizard is installed: you keep the repo guardrails and hook enforcement, but day-to-day editing and runs stay low-friction. Use plain `codex` instead if you want more manual confirmation. If a handoff is interrupted and Codex prints a resume id, continue with `codex resume --full-auto <session-id>`for the same low-friction posture.
17
+
`codex -m gpt-5.5 -c 'model_reasoning_effort="xhigh"'` is the safest explicit start once this wizard is installed. Use plain `codex` instead if you want to rely on trusted repo-local config. If a handoff is interrupted and Codex prints a resume id, continue with `codex resume -m gpt-5.5 -c 'model_reasoning_effort="xhigh"' <session-id>`so resume does not fall back to an older model.
18
18
19
-
If you normally use yolo-style sessions, use Codex's explicit current flags instead: `--sandbox danger-full-access --ask-for-approval never`. Only use that full-trust variant in repos you fully trust.
19
+
If you normally use yolo-style sessions, use Codex's canonical full-trust flag: `--dangerously-bypass-approvals-and-sandbox`. Current Codex may accept `--yolo` as shorthand, but this wizard prints the canonical flag. Full-auto is not full-trust: full-trust bypasses sandbox and approval prompts. Only use that variant in repos you fully trust.
20
20
21
-
Bare `npx codex-sdlc-wizard` is the adaptive setup/sync path. In an already-initialized repo clone, it runs the update/check-repair path automatically so a fresh Mac/Windows/Linux checkout can sync hooks, config, and helper skills without remembering separate commands. In a new repo, it bootstraps the repo-local guardrails first, then hands off into a live plain Codex setup session so the unresolved setup questions happen inside Codex instead of inside a shell checklist. At that first-run handoff prompt, press Enter for plain `codex` or type `full-auto` if you explicitly want `codex --full-auto`. `setup --yes` still exists for automation, but it is not the normal human path.
21
+
Bare `npx codex-sdlc-wizard` is the adaptive setup/sync path. In an already-initialized repo clone, it runs the update/check-repair path automatically so a fresh Mac/Windows/Linux checkout can sync hooks, config, and helper skills without remembering separate commands. In a new repo, it bootstraps the repo-local guardrails first, then hands off into a live plain Codex setup session so the unresolved setup questions happen inside Codex instead of inside a shell checklist. At that first-run handoff prompt, press Enter for plain `codex` or type `full-trust` if you explicitly want `codex --dangerously-bypass-approvals-and-sandbox`. `setup --yes` still exists for automation, but it is not the normal human path.
Copy file name to clipboardExpand all lines: ROADMAP.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,10 +19,10 @@
19
19
- setup/update guidance now treats verification as diagnostic for product failures and stops before editing application code or application tests without explicit user consent
20
20
- setup/update guidance now tells users to exit and reopen Codex after hook/skill repairs, without rerunning setup/update just for that restart
21
21
- install/setup/update now write and repair repo-local `.codex/config.toml` model keys for the selected profile, while preserving unrelated MCP, sandbox, approval, and custom config
22
-
- first-run live setup now defaults to plain `codex` after bootstrap and requires an explicit `full-auto` choice to start that setup handoff with `codex --full-auto`
23
-
- first-run handoff now uses a clearer prompt, recommends `codex resume --full-auto` for interrupted handoffs, and avoids the deprecated Windows `shell:true` plus args launcher path
22
+
- first-run live setup now defaults to plain `codex` after bootstrap and requires an explicit `full-trust` choice to start that setup handoff with `codex --dangerously-bypass-approvals-and-sandbox`
23
+
- first-run handoff now uses a clearer prompt, recommends model-explicit `codex resume -m ... -c ...` for interrupted handoffs, and avoids the deprecated Windows `shell:true` plus args launcher path
24
24
- first-run live Codex handoff now runs as a managed child process with opt-in timeout cleanup, POSIX signal forwarding, process-group termination, repeated-interrupt handling, and explicit retry/resume guidance
25
-
- setup/install output now prints explicit full-trust Codex flags (`--sandbox danger-full-access --ask-for-approval never`) for users who normally say yolo-style sessions
25
+
- setup/install output now prints Codex's canonical full-trust flag (`--dangerously-bypass-approvals-and-sandbox`) for users who normally say yolo-style sessions, while keeping full-trust distinct from historical full-auto wording
26
26
- update guidance now frontloads the npm version boundary: `$update-wizard` repairs repo artifacts, while `npx codex-sdlc-wizard@latest update` consumes the newest package
27
27
- setup guidance now includes Codex Desktop handoff notes for auth-heavy browser/computer-use setup flows
28
28
- generated setup docs and shipped skills now include a task-routing gate that identifies CLI, Desktop/computer-use, browser automation, or human-only lanes before giving execution steps
Copy file name to clipboardExpand all lines: SKILL.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ Use the bundled scripts like this:
17
17
1. If the user wants the simplest install, run the bundled `install.sh` from this skill bundle against the current working repo.
18
18
2. If the user wants repo-aware setup or regenerated docs, run the bundled `setup.sh --yes` from this skill bundle against the current working repo.
19
19
3. Tell the user exactly which path you chose: `install.sh` for baseline enforcement, `setup.sh` for adaptive setup.
20
-
4. After installation, tell the user to start a fresh Codex session so hooks and repo docs are loaded cleanly. Recommend plain `codex` for the first live setup handoff unless the user explicitly chooses `full-auto`; recommend `codex --full-auto` as the default start mode after setup is complete and the guardrails are loaded. If a handoff was interrupted and Codex printed a resume id, recommend `codex resume --full-auto <session-id>` for low-friction continuation. Mention plain `codex` or `codex resume <session-id>` as the manual fallback for daily work.
20
+
4. After installation, tell the user to start a fresh Codex session so hooks and repo docs are loaded cleanly. Recommend plain `codex` for the first live setup handoff unless the user explicitly chooses `full-trust`; recommend `codex -m <model> -c 'model_reasoning_effort="xhigh"'` as the current explicit start mode after setup is complete and the guardrails are loaded. If a handoff was interrupted and Codex printed a resume id, recommend `codex resume -m <model> -c 'model_reasoning_effort="xhigh"' <session-id>` for model-explicit continuation. Mention plain `codex` or `codex resume <session-id>` as the config-driven fallback for daily work. For yolo-style sessions, use the canonical full-trust flag `--dangerously-bypass-approvals-and-sandbox`; current Codex may accept `--yolo` as shorthand, but full-auto is not full-trust.
21
21
The fresh session should also pick up the repo-scoped `\$sdlc` skill under `.agents/skills`. Repo-scoped skill coverage is still a work in progress; additional workflow names should stay out of public handoff copy until their contracts are ready.
22
22
Canonical SDLC entrypoint: `\$sdlc`. `/sdlc` is historical shorthand for the missing slash-command idea, not an invocation command.
23
23
For setup/update bootstrap work, recommend the `maximum` profile via `--model-profile maximum` as the safer default. For routine work after bootstrap, point users back to the `mixed` profile via `--model-profile mixed` for the better speed / lower latency / lower token path with `xhigh` review.
Write-Host"Use plain 'codex' instead if you want to rely on trusted repo-local config."
248
248
Write-Host"Fresh-session note: if you ran this from inside an existing Codex session, exit and reopen Codex in this repo so repo-local config, hooks, and skills load."
249
249
Write-Host"Hook review note: if Codex says hooks need review, open /hooks after restart and review pending repo hooks before relying on enforcement."
250
-
Write-Host"Start new with selected profile: codex --full-auto -m $startModel -c 'model_reasoning_effort=`"$startReasoning`"'"
Write-Host"If resume warns it came back with a different model, resume explicitly with: codex resume --full-auto -m gpt-5.5 -c 'model_reasoning_effort=`"xhigh`"'"
253
-
Write-Host"If you normally use yolo-style sessions, use the explicit current Codex flags:"
echo"Use plain 'codex' instead if you want to rely on trusted repo-local config."
263
263
echo"Fresh-session note: if you ran this from inside an existing Codex session, exit and reopen Codex in this repo so repo-local config, hooks, and skills load."
264
264
echo"Hook review note: if Codex says hooks need review, open /hooks after restart and review pending repo hooks before relying on enforcement."
265
-
echo"Start new with selected profile: codex --full-auto -m $START_MODEL -c 'model_reasoning_effort=\"$START_REASONING\"'"
echo"If resume warns it came back with a different model, resume explicitly with: codex resume --full-auto -m gpt-5.5 -c 'model_reasoning_effort=\"xhigh\"'"
268
-
echo"If you normally use yolo-style sessions, use the explicit current Codex flags:"
Copy file name to clipboardExpand all lines: skills/setup-wizard/SKILL.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -183,7 +183,7 @@ This verification is diagnostic for product behavior. If a failing command point
183
183
184
184
### Step 8: Restart and next steps
185
185
186
-
If new skills or hooks were installed or repaired, tell the user to exit and reopen Codex in this repo so the active session reloads them. Tell them: you do not need to rerun setup just for that restart. If they closed an interrupted handoff and Codex printed a resume id, recommend `codex resume --full-auto <session-id>` for low-friction continuation, or plain `codex resume <session-id>` when they want manual confirmations.
186
+
If new skills or hooks were installed or repaired, tell the user to exit and reopen Codex in this repo so the active session reloads them. Tell them: you do not need to rerun setup just for that restart. If they closed an interrupted handoff and Codex printed a resume id, recommend `codex resume -m <model> -c 'model_reasoning_effort="xhigh"' <session-id>` for model-explicit continuation, or plain `codex resume <session-id>` when they want config-driven startup. If they normally say yolo, give the full-trust variant with `--dangerously-bypass-approvals-and-sandbox` and say full-auto is not full-trust.
0 commit comments