feat: Update CHANGELOG, README, and setup-fast-tools for streamlined workflow and new defaults

Author: chongdashu

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 This project adheres to semantic versioning. Dates are in YYYY-MM-DD.
 
+## [0.2.1] - 2025-09-16
+
+- feat: Default `cdx` pass-through now targets `gpt-5-codex` and enables experimental reasoning summaries.
+- fix: `setup-fast-tools` now works from the current directory, creating `AGENTS.md` when missing and appending the fast-tools prompt without duplicate noise.
+- docs: Update `/setup-fast-tools`, README, and CHANGELOG to reflect the streamlined workflow.
+
 ## [0.2.0] - 2025-09-16
 
 - fix: Prompt installer now searches correct locations in order of preference and respects `REPO_PROMPTS_DIR`.

README.md

@@ -43,6 +43,8 @@ cdx -- --profile NAME     # pass through to codex with defaults
 cdx raw <args>            # run codex without defaults
 ```
 
+> Default pass-through now targets `gpt-5-codex` with `model_reasoning_effort="high"`, `model_reasoning_summary="auto"`, and `model_reasoning_summary_format="experimental"` while enabling `--search` and `--dangerously-bypass-approvals-and-sandbox`. Use `cdx raw` to skip these defaults.
+
 ## Repo at a Glance
 
 ```text
@@ -64,7 +66,7 @@ cdx/
 - `cdx/scripts/` — utilities (e.g., `setup-fast-tools.sh`).
 - `cdx/smoke-test.sh` — non‑destructive health check.
 
-> Tip: Append the fast‑tools prompt to `AGENTS.md` with `bash cdx/scripts/setup-fast-tools.sh` (idempotent; add `--install-deps` to install rg/fd/jq). If your prompts live elsewhere, set `REPO_PROMPTS_DIR=/path/to/prompts` before running `cdx prompts`.
+> Tip: Append the fast‑tools prompt to `AGENTS.md` with `bash cdx/scripts/setup-fast-tools.sh` (creates the file if missing; add `--install-deps` to install rg/fd/jq). If your prompts live elsewhere, set `REPO_PROMPTS_DIR=/path/to/prompts` before running `cdx prompts`.
 
 ## Requirements & Troubleshooting
 

cdx/cdx.sh

@@ -35,16 +35,17 @@ _cdx__detect_plugin_dir() {
 # Configuration (overridable via env)   #
 #########################################
 : "${CODEX_BIN:=codex}"
-: "${CDX_VERSION:=0.2.0}"
+: "${CDX_VERSION:=0.2.1}"
 : "${CDX_BUILD_DATE:=2025-09-16}"
 : "${CODEX_PLUGIN_DIR:=$(_cdx__detect_plugin_dir)}"
 : "${CDX_CHECK_UPDATES:=}"
 
 # Opinionated defaults for pass-through invocations of `codex`.
 _CDX_DEFAULT_FLAGS=(
-  -m gpt-5
+  -m gpt-5-codex
   -c 'model_reasoning_effort="high"'
   -c 'model_reasoning_summary="auto"'
+  -c 'model_reasoning_summary_format="experimental"'
   --search
   --dangerously-bypass-approvals-and-sandbox
 )

cdx/prompts/setup-fast-tools.md

@@ -1,72 +1,37 @@
 # /setup-fast-tools
 
-Append the project’s fast-tools prompt to `AGENTS.md` without attempting to install any system packages. This avoids requiring `sudo`.
-
-What this does:
-
-- Detects `AGENTS.md` and `cdx/agents/fast-tools.md` (or `agents/fast-tools.md`) in the current repo.
-- Checks for the `FAST-TOOLS PROMPT v1` watermark to avoid duplicates.
-- Appends the prompt if not already present.
-
-It does not install `ripgrep`, `fd`/`fdfind`, or `jq`. If you need those tools, install them separately using your OS package manager (see brief guidance inside `cdx/agents/fast-tools.md`).
-
-Run this minimal, no-sudo snippet:
+Append the fast-tools prompt from `./cdx/agents/fast-tools.md` into `./AGENTS.md` for the current working directory whenever it is missing.
 
 ```bash
 set -euo pipefail
 
-# Find repo root (or stay in CWD if not a git repo)
-repo_root=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
-agents="$repo_root/AGENTS.md"
-if [ -f "$repo_root/cdx/agents/fast-tools.md" ]; then
-  prompt_src="$repo_root/cdx/agents/fast-tools.md"
-elif [ -f "$repo_root/agents/fast-tools.md" ]; then
-  prompt_src="$repo_root/agents/fast-tools.md"
-else
-  echo "Prompt file missing under cdx/agents or agents in $repo_root" >&2
-  exit 1
-fi
+cwd=$(pwd)
+prompt_src="$cwd/cdx/agents/fast-tools.md"
+agents="$cwd/AGENTS.md"
 
-if [ ! -f "$agents" ]; then
-  echo "AGENTS.md not found under $repo_root" >&2
-  exit 1
-fi
 if [ ! -f "$prompt_src" ]; then
-  echo "Prompt file missing: $prompt_src" >&2
+  echo "Missing $prompt_src" >&2
   exit 1
 fi
 
-# Avoid duplicates using rg if available, otherwise grep
-if command -v rg >/dev/null 2>&1; then
-  if rg -q "FAST-TOOLS PROMPT v1" "$agents"; then
-    echo "FAST-TOOLS prompt already present — nothing to do."
+if [ -f "$agents" ]; then
+  if command -v rg >/dev/null 2>&1; then
+    if rg -q "FAST-TOOLS PROMPT v1" "$agents"; then
+      echo "FAST-TOOLS prompt already present."
+      exit 0
+    fi
+  elif grep -q "FAST-TOOLS PROMPT v1" "$agents"; then
+    echo "FAST-TOOLS prompt already present."
     exit 0
   fi
 else
-  if grep -q "FAST-TOOLS PROMPT v1" "$agents"; then
-    echo "FAST-TOOLS prompt already present — nothing to do."
-    exit 0
-  fi
+  touch "$agents"
 fi
 
-printf "\n\n" >> "$agents"
-cat "$prompt_src" >> "$agents"
-echo "Appended fast-tools prompt to AGENTS.md"
-```
-
-## Quick Setup Script
-
-Tell the user to that they need to install dependencies / third party tools after the prompt is appended to AGENTS.md, which they can utilise the following prompts for.
-
-```bash
-# Append prompt (idempotent)
-bash cdx/scripts/setup-fast-tools.sh
+if [ -s "$agents" ]; then
+  printf "\n\n" >> "$agents"
+fi
 
-# Append and install ripgrep/fd/jq (best effort)
-bash cdx/scripts/setup-fast-tools.sh --install-deps
+cat "$prompt_src" >> "$agents"
+echo "Appended fast-tools prompt to $agents"
 ```
-
-Notes:
-
-- Non-interactive envs can add `--non-interactive` or `--dry-run` to print commands.
-- Debian/Ubuntu may provide `fdfind` instead of `fd` (use `alias fd=fdfind`).

cdx/scripts/setup-fast-tools.sh

@@ -57,43 +57,51 @@ while [ $# -gt 0 ]; do
   shift
 done
 
-# Find repo root (or stay in CWD if not a git repo)
-REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
-AGENTS="$REPO_ROOT/AGENTS.md"
-# Determine prompt source (prefer cdx/agents, then agents)
-if [ -f "$REPO_ROOT/cdx/agents/fast-tools.md" ]; then
-  PROMPT_SRC="$REPO_ROOT/cdx/agents/fast-tools.md"
-elif [ -f "$REPO_ROOT/agents/fast-tools.md" ]; then
-  PROMPT_SRC="$REPO_ROOT/agents/fast-tools.md"
+# Operate from the current working directory so the prompt wires into the local AGENTS.md.
+CWD=$(pwd)
+AGENTS="$CWD/AGENTS.md"
+if [ -f "$CWD/cdx/agents/fast-tools.md" ]; then
+  PROMPT_SRC="$CWD/cdx/agents/fast-tools.md"
+elif [ -f "$CWD/agents/fast-tools.md" ]; then
+  PROMPT_SRC="$CWD/agents/fast-tools.md"
 else
-  PROMPT_SRC="$REPO_ROOT/cdx/agents/fast-tools.md" # final fallback for messaging
+  PROMPT_SRC="$CWD/cdx/agents/fast-tools.md"
 fi
 
-if [ ! -f "$AGENTS" ]; then
-  err "AGENTS.md not found under $REPO_ROOT"
-  exit 1
-fi
 if [ ! -f "$PROMPT_SRC" ]; then
   err "Prompt file missing: $PROMPT_SRC"
   exit 1
 fi
 
+if [ ! -f "$AGENTS" ]; then
+  log "AGENTS.md not found; creating $AGENTS"
+  run touch "$AGENTS"
+fi
+
+append_fast_tools_prompt() {
+  if [ "$DRY_RUN" -eq 1 ]; then
+    log "Dry run: would append fast-tools prompt to $AGENTS"
+    return 0
+  fi
+  if [ -s "$AGENTS" ]; then
+    printf "\n\n" >> "$AGENTS"
+  fi
+  cat "$PROMPT_SRC" >> "$AGENTS"
+  log "Appended fast-tools prompt to $AGENTS"
+}
+
 # Avoid duplicates using rg if available, otherwise grep
 if have rg; then
   if rg -q "FAST-TOOLS PROMPT v1" "$AGENTS"; then
     log "FAST-TOOLS prompt already present — skipping append."
   else
-    run printf "\n\n" >> "$AGENTS"
-    run cat "$PROMPT_SRC" >> "$AGENTS"
-    log "Appended fast-tools prompt to AGENTS.md"
+    append_fast_tools_prompt
   fi
 else
   if grep -q "FAST-TOOLS PROMPT v1" "$AGENTS"; then
     log "FAST-TOOLS prompt already present — skipping append."
   else
-    run printf "\n\n" >> "$AGENTS"
-    run cat "$PROMPT_SRC" >> "$AGENTS"
-    log "Appended fast-tools prompt to AGENTS.md"
+    append_fast_tools_prompt
   fi
 fi