feat: Simplify installation process by sourcing cdx and copying prompts automatically; update documentation and remove fast-tools agent file

Author: chongdashu

AGENTS.md

@@ -4,8 +4,8 @@
 - `cdx/cdx.sh` — entrypoint; sources a `cdx` shell function and `cx` alias.
 - `cdx/plugins/` — subcommands invoked as `cdx <name>` (e.g., `profiles.sh`, `prompts.sh`, `update.sh`).
 - `cdx/prompts/` — optional prompt files (Markdown). See `cdx/plugins/prompts.sh`.
-- `cdx/agents/fast-tools.md` — reusable prompt to append to this file.
-- `cdx/scripts/` — utility scripts (e.g., `setup-fast-tools.sh`).
+- `cdx/prompts/setup-fast-tools.md` — fast-tools prompt to append to this file.
+- `cdx/scripts/` — utility scripts.
 - `cdx/install.sh`, `cdx/smoke-test.sh` — installer and health check.
 Note: Prompt discovery checks `repo_root/prompts`, `cdx/prompts`, and a legacy vendored prompts path by default. Set `REPO_PROMPTS_DIR` to override the prompt source if your layout differs.
 
@@ -14,7 +14,7 @@ Additional note: Plugin discovery uses `ripgrep` (`rg`) when available and falls
 ## Build, Test, and Development Commands
 - Load locally: `source cdx/cdx.sh && cdx help` (defines `cdx` in your shell).
 - Smoke test: `bash cdx/smoke-test.sh` (verifies sourcing, plugins, prompts, update check).
-- Install to shell: `bash cdx/install.sh [--with-prompts]`.
+- Install to shell: `bash cdx/install.sh` (adds source block and installs prompts).
 - Update Codex CLI: `cdx update --check-only` or `cdx update [--sudo]`.
 - Prompts: `cdx prompts list` • `cdx prompts install` • `cdx prompts path`.
 - Profiles: `cdx profiles` or `cdx profiles --quiet`.
@@ -40,4 +40,35 @@ Additional note: Plugin discovery uses `ripgrep` (`rg`) when available and falls
 - For repo-wide search, use `rg` (ripgrep) and `fd/fdfind`; avoid `grep/find`.
 - Cap file reads at ~250 lines; prefer `rg -n -A3 -B3` for context.
 - Use `jq` for JSON parsing.
-- Append the fast-tools prompt (idempotent): `bash cdx/scripts/setup-fast-tools.sh [--install-deps]`.
+- Fast-tools prompt: copy the block in `cdx/prompts/setup-fast-tools.md` if it is missing from this file.
+
+<!-- FAST-TOOLS PROMPT v1 | codex-mastery | watermark:do-not-alter -->
+
+## CRITICAL: Use ripgrep, not grep
+
+NEVER use grep for project-wide searches (slow, ignores .gitignore). ALWAYS use rg.
+
+- `rg "pattern"` — search content
+- `rg --files | rg "name"` — find files
+- `rg -t python "def"` — language filters
+
+## File finding
+
+- Prefer `fd` (or `fdfind` on Debian/Ubuntu). Respects .gitignore.
+
+## JSON
+
+- Use `jq` for parsing and transformations.
+
+## Install Guidance
+
+- macOS: `brew install ripgrep fd jq`
+- Debian/Ubuntu: `sudo apt update && sudo apt install -y ripgrep fd-find jq` (alias `fd=fdfind`)
+
+## Agent Instructions
+
+- Replace commands: grep→rg, find→rg --files/fd, ls -R→rg --files, cat|grep→rg pattern file
+- Cap reads at 250 lines; prefer `rg -n -A 3 -B 3` for context
+- Use `jq` for JSON instead of regex
+
+<!-- END FAST-TOOLS PROMPT v1 | codex-mastery -->

CHANGELOG.md

@@ -4,6 +4,11 @@ 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.2] - 2025-09-16
+
+- chore: Installer now always sources cdx and copies bundled prompts without needing `--with-prompts`.
+- docs: Refresh README and AGENTS instructions to match the simplified install flow.
+
 ## [0.2.1] - 2025-09-16
 
 - feat: Default `cdx` pass-through now targets `gpt-5-codex` and enables experimental reasoning summaries.

README.md

@@ -24,7 +24,7 @@ As a worked through famliarising myself with the Codex CLI, I found that many of
 - From this repo (local install):
   ```bash
   # Add cdx to your shell
-  bash cdx/install.sh --with-prompts   # optional: copies prompts
+  bash cdx/install.sh           # installs prompts and adds shell sourcing
   # Or for a temporary session
   source cdx/cdx.sh && cdx help
   ```
@@ -51,22 +51,20 @@ cdx raw <args>            # run codex without defaults
 cdx/
   cdx.sh            # entrypoint defines `cdx` and alias `cx`
   plugins/          # profiles.sh, prompts.sh, update.sh, resume.sh
-  prompts/          # optional Markdown prompts
-  agents/           # reusable prompts (e.g., fast-tools.md)
-  scripts/          # setup-fast-tools.sh and utilities
+  prompts/          # optional Markdown prompts (fast-tools lives here)
+  scripts/          # utilities
   smoke-test.sh     # non-destructive health check
 ```
 
 ## Repository Layout
 
 - `cdx/cdx.sh` — entrypoint defining the `cdx` function and `cx` alias.
 - `cdx/plugins/` — subcommands (`profiles.sh`, `prompts.sh`, `update.sh`, `resume.sh`).
-- `cdx/prompts/` — optional Markdown prompts for Codex.
-- `cdx/agents/fast-tools.md` — reusable prompt you can append to `AGENTS.md`.
-- `cdx/scripts/` — utilities (e.g., `setup-fast-tools.sh`).
+- `cdx/prompts/` — optional Markdown prompts for Codex (including `setup-fast-tools.md`).
+- `cdx/scripts/` — utilities.
 - `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` (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`.
+> Tip: `cdx/prompts/setup-fast-tools.md` contains the fast-tools prompt. Copy that block into `AGENTS.md` if it is missing (the install script will drop prompts into `~/.codex/prompts`). If your prompts live elsewhere, set `REPO_PROMPTS_DIR=/path/to/prompts` before running `cdx prompts`.
 
 ## Requirements & Troubleshooting
 

cdx/agents/fast-tools.md

@@ -35,7 +35,7 @@ _cdx__detect_plugin_dir() {
 # Configuration (overridable via env)   #
 #########################################
 : "${CODEX_BIN:=codex}"
-: "${CDX_VERSION:=0.2.1}"
+: "${CDX_VERSION:=0.2.2}"
 : "${CDX_BUILD_DATE:=2025-09-16}"
 : "${CODEX_PLUGIN_DIR:=$(_cdx__detect_plugin_dir)}"
 : "${CDX_CHECK_UPDATES:=}"

cdx/cdx.sh

@@ -3,7 +3,7 @@ set -euo pipefail
 
 # Minimal installer for cdx as a standalone distribution.
 # - Adds a source line to your shell rc file
-# - Optionally installs repo prompts to ~/.codex/prompts
+# - Installs repo prompts to ~/.codex/prompts
 
 SELF_DIR=$(cd "$(dirname "$0")" && pwd)
 CDX_ENTRY="$SELF_DIR/cdx.sh"
@@ -102,10 +102,7 @@ main() {
   local rc
   rc=$(pick_shell_rc)
   ensure_source_line "$rc"
-  case "${1:-}" in
-    --with-prompts) install_prompts ;;
-    *) : ;;
-  esac
+  install_prompts
   echo "Done. Open a new shell or run: source $rc"
 }
 

cdx/install.sh

@@ -1,37 +1,36 @@
 # /setup-fast-tools
 
-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
-
-cwd=$(pwd)
-prompt_src="$cwd/cdx/agents/fast-tools.md"
-agents="$cwd/AGENTS.md"
-
-if [ ! -f "$prompt_src" ]; then
-  echo "Missing $prompt_src" >&2
-  exit 1
-fi
-
-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
-  touch "$agents"
-fi
-
-if [ -s "$agents" ]; then
-  printf "\n\n" >> "$agents"
-fi
-
-cat "$prompt_src" >> "$agents"
-echo "Appended fast-tools prompt to $agents"
+Append the following prompt into `./AGENTS.md` for the current working directory whenever it is missing.
+
+```
+<!-- FAST-TOOLS PROMPT v1 | codex-mastery | watermark:do-not-alter -->
+
+## CRITICAL: Use ripgrep, not grep
+
+NEVER use grep for project-wide searches (slow, ignores .gitignore). ALWAYS use rg.
+
+- `rg "pattern"` — search content
+- `rg --files | rg "name"` — find files
+- `rg -t python "def"` — language filters
+
+## File finding
+
+- Prefer `fd` (or `fdfind` on Debian/Ubuntu). Respects .gitignore.
+
+## JSON
+
+- Use `jq` for parsing and transformations.
+
+## Install Guidance
+
+- macOS: `brew install ripgrep fd jq`
+- Debian/Ubuntu: `sudo apt update && sudo apt install -y ripgrep fd-find jq` (alias `fd=fdfind`)
+
+## Agent Instructions
+
+- Replace commands: grep→rg, find→rg --files/fd, ls -R→rg --files, cat|grep→rg pattern file
+- Cap reads at 250 lines; prefer `rg -n -A 3 -B 3` for context
+- Use `jq` for JSON instead of regex
+
+<!-- END FAST-TOOLS PROMPT v1 | codex-mastery -->
 ```