Skip to content

Commit 65ea452

Browse files
committed
fix(cli): replace stale full-auto guidance
1 parent 437969c commit 65ea452

12 files changed

Lines changed: 115 additions & 85 deletions

File tree

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,15 +10,15 @@ This adapter brings the [SDLC Wizard](https://github.com/BaseInfinity/agentic-ai
1010
# Setup a new repo or sync an already-initialized clone
1111
npx codex-sdlc-wizard@latest
1212

13-
# Start coding with SDLC enforcement
14-
codex --full-auto
13+
# Start coding with SDLC enforcement and an explicit model profile
14+
codex -m gpt-5.5 -c 'model_reasoning_effort="xhigh"'
1515
```
1616

17-
`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.
1818

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.
2020

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.
2222

2323
Generic npm entrypoint examples: `npx codex-sdlc-wizard`, `npx codex-sdlc-wizard check`, and `npx codex-sdlc-wizard update`.
2424

ROADMAP.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,10 +19,10 @@
1919
- setup/update guidance now treats verification as diagnostic for product failures and stops before editing application code or application tests without explicit user consent
2020
- setup/update guidance now tells users to exit and reopen Codex after hook/skill repairs, without rerunning setup/update just for that restart
2121
- 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
2424
- 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
2626
- update guidance now frontloads the npm version boundary: `$update-wizard` repairs repo artifacts, while `npx codex-sdlc-wizard@latest update` consumes the newest package
2727
- setup guidance now includes Codex Desktop handoff notes for auth-heavy browser/computer-use setup flows
2828
- 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

SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Use the bundled scripts like this:
1717
1. If the user wants the simplest install, run the bundled `install.sh` from this skill bundle against the current working repo.
1818
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.
1919
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.
2121
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.
2222
Canonical SDLC entrypoint: `\$sdlc`. `/sdlc` is historical shorthand for the missing slash-command idea, not an invocation command.
2323
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.

bin/codex-sdlc-wizard.js

Lines changed: 15 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ const interactiveSessionPrompt = [
1414
"Continue setup inside Codex: scan the repo, ask only unresolved questions, preserve intentional existing docs, generate or refresh repo-specific SDLC docs, verify the result, and finish setup.",
1515
"Use xhigh reasoning for setup."
1616
].join(" ");
17+
const fullTrustFlag = "--dangerously-bypass-approvals-and-sandbox";
1718

1819
function printHelp() {
1920
process.stdout.write(`Usage: codex-sdlc-wizard [setup|check|update|install] [options]
@@ -25,7 +26,8 @@ Commands:
2526
install Advanced escape hatch: run install.sh without adaptive setup
2627
2728
Default behavior: initialized repos run update automatically; new repos use adaptive setup, then hand off into a live plain Codex setup session.
28-
Type "full-auto" at the handoff prompt if you want codex --full-auto for first-run setup.
29+
Type "full-trust" at the handoff prompt if you want codex ${fullTrustFlag} for first-run setup.
30+
Full-trust/yolo is separate from automation posture; it bypasses sandbox and approval prompts.
2931
Automation/non-interactive behavior: use setup --yes to stay on the shell path.
3032
Bootstrap/setup recommendation: maximum.
3133
Routine work after bootstrap: mixed.
@@ -207,7 +209,8 @@ function printHandoffRecovery(reason) {
207209
reason,
208210
"Terminating spawned Codex process tree.",
209211
"Retry from this repo with: npx codex-sdlc-wizard@latest",
210-
"If Codex printed a session id before stopping, resume with: codex resume --full-auto -m gpt-5.5 -c 'model_reasoning_effort=\"xhigh\"' <session-id>",
212+
"If Codex printed a session id before stopping, resume with: codex resume -m gpt-5.5 -c 'model_reasoning_effort=\"xhigh\"' <session-id>",
213+
`For full-trust/yolo-style resume, use: codex resume ${fullTrustFlag} -m gpt-5.5 -c 'model_reasoning_effort=\"xhigh\"' <session-id>`,
211214
""
212215
].join("\n"));
213216
}
@@ -404,8 +407,8 @@ function runScript(scriptName, args) {
404407
}
405408

406409
async function askHandoffMode() {
407-
if (process.env.CODEX_SDLC_HANDOFF_MODE === "full-auto") {
408-
return "full-auto";
410+
if (process.env.CODEX_SDLC_HANDOFF_MODE === "full-trust" || process.env.CODEX_SDLC_HANDOFF_MODE === "yolo") {
411+
return "full-trust";
409412
}
410413

411414
if (process.env.CODEX_SDLC_HANDOFF_MODE === "plain") {
@@ -416,16 +419,17 @@ async function askHandoffMode() {
416419
"",
417420
"Choose first-run Codex handoff mode:",
418421
" Press Enter: plain codex (recommended)",
419-
' Type "full-auto": codex --full-auto',
420-
" If interrupted later, resume with: codex resume --full-auto <session-id>",
422+
` Type "full-trust": codex ${fullTrustFlag}`,
423+
" If you say yolo, use full-trust; full-auto is not full-trust.",
424+
" If interrupted later, resume with: codex resume -m gpt-5.5 -c 'model_reasoning_effort=\"xhigh\"' <session-id>",
421425
"> "
422426
].join("\n");
423427

424428
if (!process.stdin.isTTY) {
425429
process.stdout.write(prompt);
426430
const answer = fs.readFileSync(0, "utf8").split(/\r?\n/, 1)[0].trim().toLowerCase();
427431
process.stdout.write("\n");
428-
return answer === "full-auto" ? "full-auto" : "plain";
432+
return answer === "full-trust" || answer === "yolo" ? "full-trust" : "plain";
429433
}
430434

431435
const rl = readline.createInterface({
@@ -435,7 +439,7 @@ async function askHandoffMode() {
435439

436440
try {
437441
const answer = (await rl.question(prompt)).trim().toLowerCase();
438-
return answer === "full-auto" ? "full-auto" : "plain";
442+
return answer === "full-trust" || answer === "yolo" ? "full-trust" : "plain";
439443
} finally {
440444
rl.close();
441445
}
@@ -455,7 +459,7 @@ async function handoffToCodex(modelProfile) {
455459
}
456460

457461
const handoffMode = await askHandoffMode();
458-
const modeLabel = handoffMode === "full-auto" ? "codex --full-auto" : "plain codex";
462+
const modeLabel = handoffMode === "full-trust" ? `codex ${fullTrustFlag}` : "plain codex";
459463
process.stdout.write(`\nHanding off into Codex for live setup using ${modeLabel}...\n`);
460464

461465
const codexArgs = [
@@ -468,8 +472,8 @@ async function handoffToCodex(modelProfile) {
468472
interactiveSessionPrompt
469473
];
470474

471-
if (handoffMode === "full-auto") {
472-
codexArgs.unshift("--full-auto");
475+
if (handoffMode === "full-trust") {
476+
codexArgs.unshift(fullTrustFlag);
473477
}
474478

475479
const codexResult = await runCodexHandoff(codexArgs);

install.ps1

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -243,17 +243,19 @@ Write-Host ""
243243
Write-Host "SDLC Wizard for Codex installed."
244244
$startModel = if ($ModelProfile -eq "maximum") { "gpt-5.5" } else { "gpt-5.4-mini" }
245245
$startReasoning = "xhigh"
246-
Write-Host "Recommended start: 'codex --full-auto' for low-friction SDLC inside the repo guardrails."
247-
Write-Host "Use plain 'codex' instead if you want more manual confirmation."
246+
Write-Host "Recommended start: codex -m $startModel -c 'model_reasoning_effort=`"$startReasoning`"'"
247+
Write-Host "Use plain 'codex' instead if you want to rely on trusted repo-local config."
248248
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."
249249
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`"'"
251-
Write-Host "Resume with selected profile: codex resume --full-auto -m $startModel -c 'model_reasoning_effort=`"$startReasoning`"'"
252-
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:"
254-
Write-Host " codex -m $startModel -c 'model_reasoning_effort=`"$startReasoning`"' --sandbox danger-full-access --ask-for-approval never"
255-
Write-Host " codex resume -m $startModel -c 'model_reasoning_effort=`"$startReasoning`"' --sandbox danger-full-access --ask-for-approval never"
256-
Write-Host "Full-trust warning: only use that variant in repos you fully trust; it bypasses sandbox and approval prompts."
250+
Write-Host "Start new with selected profile: codex -m $startModel -c 'model_reasoning_effort=`"$startReasoning`"'"
251+
Write-Host "Resume with selected profile: codex resume -m $startModel -c 'model_reasoning_effort=`"$startReasoning`"'"
252+
Write-Host "If resume warns it came back with a different model, resume explicitly with: codex resume -m gpt-5.5 -c 'model_reasoning_effort=`"xhigh`"'"
253+
Write-Host "If you normally use yolo-style sessions, use the canonical full-trust Codex flag:"
254+
Write-Host " codex --dangerously-bypass-approvals-and-sandbox -m $startModel -c 'model_reasoning_effort=`"$startReasoning`"'"
255+
Write-Host " codex resume --dangerously-bypass-approvals-and-sandbox -m $startModel -c 'model_reasoning_effort=`"$startReasoning`"'"
256+
Write-Host "Codex may accept --yolo as shorthand; this wizard prints the canonical full-trust flag."
257+
Write-Host "Full-auto is not full-trust: full-trust bypasses sandbox and approval prompts."
258+
Write-Host "Full-trust warning: only use that variant in repos you fully trust."
257259
Write-Host "Recommended: use full access during setup, environment repair, and auth-heavy workflows."
258260
Write-Host "Wrote repo-local .codex/config.toml model keys for this profile; mixed is wizard policy, not a native Codex mode."
259261
Write-Host "Codex loads project config only after the repo is trusted, and trusted project config overrides your user-level ~/.codex/config.toml."

install.sh

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -256,19 +256,21 @@ write_model_profile
256256

257257
echo ""
258258
echo "SDLC Wizard for Codex installed."
259-
echo "Recommended start: 'codex --full-auto' for low-friction SDLC inside the repo guardrails."
260-
echo "Use plain 'codex' instead if you want more manual confirmation."
261259
START_MODEL="$(profile_model "$MODEL_PROFILE")"
262260
START_REASONING="$(profile_reasoning "$MODEL_PROFILE")"
261+
echo "Recommended start: codex -m $START_MODEL -c 'model_reasoning_effort=\"$START_REASONING\"'"
262+
echo "Use plain 'codex' instead if you want to rely on trusted repo-local config."
263263
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."
264264
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\"'"
266-
echo "Resume with selected profile: codex resume --full-auto -m $START_MODEL -c 'model_reasoning_effort=\"$START_REASONING\"'"
267-
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:"
269-
echo " codex -m $START_MODEL -c 'model_reasoning_effort=\"$START_REASONING\"' --sandbox danger-full-access --ask-for-approval never"
270-
echo " codex resume -m $START_MODEL -c 'model_reasoning_effort=\"$START_REASONING\"' --sandbox danger-full-access --ask-for-approval never"
271-
echo "Full-trust warning: only use that variant in repos you fully trust; it bypasses sandbox and approval prompts."
265+
echo "Start new with selected profile: codex -m $START_MODEL -c 'model_reasoning_effort=\"$START_REASONING\"'"
266+
echo "Resume with selected profile: codex resume -m $START_MODEL -c 'model_reasoning_effort=\"$START_REASONING\"'"
267+
echo "If resume warns it came back with a different model, resume explicitly with: codex resume -m gpt-5.5 -c 'model_reasoning_effort=\"xhigh\"'"
268+
echo "If you normally use yolo-style sessions, use the canonical full-trust Codex flag:"
269+
echo " codex --dangerously-bypass-approvals-and-sandbox -m $START_MODEL -c 'model_reasoning_effort=\"$START_REASONING\"'"
270+
echo " codex resume --dangerously-bypass-approvals-and-sandbox -m $START_MODEL -c 'model_reasoning_effort=\"$START_REASONING\"'"
271+
echo "Codex may accept --yolo as shorthand; this wizard prints the canonical full-trust flag."
272+
echo "Full-auto is not full-trust: full-trust bypasses sandbox and approval prompts."
273+
echo "Full-trust warning: only use that variant in repos you fully trust."
272274
echo "Model profile: '$MODEL_PROFILE'."
273275
echo " - mixed: gpt-5.4-mini main pass + gpt-5.5 xhigh review for better speed, lower latency, and lower token usage."
274276
echo " - maximum: gpt-5.5 xhigh throughout for maximum stability and the most thorough \"ultimate mode\"."

skills/setup-wizard/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -183,7 +183,7 @@ This verification is diagnostic for product behavior. If a failing command point
183183

184184
### Step 8: Restart and next steps
185185

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.
187187

188188
Then point them at the next entrypoint:
189189

0 commit comments

Comments
 (0)