An agentic skills framework & software development methodology that works.
Replace Codex-specific server guidance with per-platform launch instructions
Jesse Vincent81acbcd51e81
diff --git a/skills/brainstorming/scripts/start-server.sh b/skills/brainstorming/scripts/start-server.shindex ca8500386..00c337998 100755--- a/skills/brainstorming/scripts/start-server.sh+++ b/skills/brainstorming/scripts/start-server.sh@@ -59,7 +59,7 @@ if [[ -z "$URL_HOST" ]]; thenfifi-# Codex environments may reap detached/background processes. Prefer foreground by default.+# Some environments reap detached/background processes. Auto-foreground when detected.if [[ -n "${CODEX_CI:-}" && "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; thenFOREGROUND="true"fidiff --git a/skills/brainstorming/visual-companion.md b/skills/brainstorming/visual-companion.mdindex 94b09e6b8..c9f6d8b30 100644--- a/skills/brainstorming/visual-companion.md+++ b/skills/brainstorming/visual-companion.md@@ -44,15 +44,29 @@ Save `screen_dir` from the response. Tell user to open the URL.**Note:** Pass the project root as `--project-dir` so mockups persist in `.superpowers/brainstorm/` and survive server restarts. Without it, files go to `/tmp` and get cleaned up. Remind the user to add `.superpowers/` to `.gitignore` if it's not already there.-**Codex behavior:** In Codex (`CODEX_CI=1`), `start-server.sh` auto-switches to foreground mode by default because background jobs may be reaped. Use `--background` only if your environment reliably preserves detached processes.+**Launching the server by platform:**-**If background processes are reaped in your environment:** run in foreground from a persistent terminal session:+**Claude Code:**+```bash+# Default mode works — the script backgrounds the server itself+scripts/start-server.sh --project-dir /path/to/project+```++**Codex:**+```bash+# Codex reaps background processes. The script auto-detects CODEX_CI and+# switches to foreground mode. Run it normally — no extra flags needed.+scripts/start-server.sh --project-dir /path/to/project+```+**Gemini CLI:**```bash+# Use --foreground and set is_background: true on your shell tool call+# so the process survives across turnsscripts/start-server.sh --project-dir /path/to/project --foreground```-In `--foreground` mode, the command stays attached and serves until interrupted.+**Other environments:** The server must keep running in the background across conversation turns. If your environment reaps detached processes, use `--foreground` and launch the command with your platform's background execution mechanism.If the URL is unreachable from your browser (common in remote/containerized setups), bind a non-loopback host: