codex-1up 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Kevin Kern
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# Codex CLI 1UP
+
+![codex-1up banner] (https://raw.githubusercontent.com/regenrek/codex-1up/main/public/banner.png)
+
+
+**Codex 1UP** equips your Codex CLI coding agent with powerful tools.
+
+- ✅ Installs/updates **Codex CLI** (`@openai/codex`)
+- ✅ Adds fast shell power tools: `ast-grep`, `fd`, `ripgrep`, `rg`, `fzf`, `jq`, `yq`
+- ✅ **AGENTS.md** template with tool selection guide
+- ✅ Unified **Codex config** with multiple profiles: `balanced` / `safe` / `minimal` / `yolo`
+- ✅ 🔊 **Notification sounds** with customizable audio alerts for Codex events
+
+
+## Quick start
+
+```bash
+# Install globally (recommended)
+npm install -g codex-1up
+codex-1up install
+```
+
+### After installing
+
+- Open a new terminal session (or source your shell rc)
+- Run `codex` to sign in and start using the agent! 🎉
+
+### What gets installed
+
+| Component                 | Why it matters                                                                          |
+| ------------------------- | --------------------------------------------------------------------------------------- |
+| **@openai/codex**         | The coding agent that can read, edit, and run your project locally.                     |
+| **ast-grep**              | Syntax‑aware search/replace for safe, large‑scale refactors in TS/TSX.                  |
+| **fd**                    | Fast file finder (gitignore‑aware).                                                     |
+| **ripgrep (rg)**          | Fast text search across code.                                                           |
+| **fzf**                   | Fuzzy‑finder to select among many matches.                                              |
+| **jq** / **yq**           | Reliable JSON/YAML processing on the command line.                                      |
+| **\~/.codex/config.toml** | Single template with multiple profiles. Active profile is chosen during install (default: `balanced`). See [Codex config reference](https://github.com/openai/codex/blob/main/docs/config.md). |
+| **AGENTS.md**             | Minimal per‑repo rubric; installer can also create global `~/.codex/AGENTS.md`.         |
+| **\~/.codex/notify.sh**   | Notification hook script with customizable sounds for Codex events (default: `noti_1.wav`). |
+
+
+### Profiles
+
+| Profile | Description |
+| --- | --- |
+| balanced (default) | Approvals on-request; workspace-write sandbox with network access inside workspace. |
+| safe | Approvals on-failure; workspace-write sandbox; conservative. |
+| minimal | Minimal reasoning effort; concise summaries; web search off. |
+| yolo | Never ask for approvals; danger-full-access (only trusted environments). |
+
+Switch profiles anytime: `codex --profile <name>` for a session, or `codex-1up config set-profile <name>` to persist.
+
+## Global guidance with AGENTS.md (optional)
+
+You can keep a global guidance file at `~/.codex/AGENTS.md` that Codex will use across projects. During install, you’ll be prompted to create this; if you skip, you can create it later:
+
+```bash
+# Create the directory if needed and write the template there
+mkdir -p ~/.codex
+./bin/codex-1up agents --path ~/.codex
+# This writes ~/.codex/AGENTS.md
+```
+
+See memory behavior with AGENTS.md in the official docs: [Memory with AGENTS.md](https://github.com/openai/codex/blob/main/docs/getting-started.md#memory-with-agentsmd).
+
+### Notes
+- Global npm packages (`@openai/codex`, `@ast-grep/cli`) are checked and only missing/outdated versions are installed.
+
+## Doctor & Uninstall
+
+```bash
+./bin/codex-1up doctor
+./bin/codex-1up uninstall
+```
+
+> **Note:** This project is **idempotent**—running it again will skip what’s already installed. It won’t remove packages on uninstall; it cleans up files under ~/.codex (backups are retained).
+
+## Supported platforms
+
+- macOS (Intel/Apple Silicon) via **Homebrew**
+- Linux via **apt**, **dnf**, **pacman**, or **zypper**
+- Windows users: use **WSL** (Ubuntu) and run the Linux path
+
+### Common flags
+
+- `--shell auto|zsh|bash|fish`
+- `--vscode EXT_ID`        : install a VS Code extension (e.g. `openai.codex`)
+- `--agents-md [PATH]`     : write a starter `AGENTS.md` to PATH (default: `$PWD/AGENTS.md`)
+- `--no-vscode`            : skip VS Code extension checks
+- `--install-node nvm|brew|skip` : how to install Node.js if missing (default: `nvm`)
+
+### Advanced / CI flags
+
+- `--dry-run`              : print what would happen, change nothing
+- `--skip-confirmation`    : suppress interactive prompts
+- `--yes`                  : non-interactive, accept safe defaults (CI). Most users don’t need this.
+
+## Develop locally (from source)
+
+For contributors and advanced users:
+
+```bash
+git clone https://github.com/regenrek/codex-1up
+cd codex-1up
+
+# Use the wrapper to run the same flow as the global CLI
+./bin/codex-1up install
+
+# Or run the CLI package directly in dev
+cd cli && corepack enable && pnpm i && pnpm build
+node ./bin/codex-1up.mjs install
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+## Links
+
+- X/Twitter: [@kregenrek](https://x.com/kregenrek)
+- Bluesky: [@kevinkern.dev](https://bsky.app/profile/kevinkern.dev)
+
+## Courses
+- Learn Cursor AI: [Ultimate Cursor Course](https://www.instructa.ai/en/cursor-ai)
+- Learn to build software with AI: [AI Builder Hub](https://www.instructa.ai)
+
+## See my other projects:
+
+* [codefetch](https://github.com/regenrek/codefetch) - Turn code into Markdown for LLMs with one simple terminal command
+* [instructa](https://github.com/orgs/instructa/repositories) - Instructa Projects

package/bin/codex-1up.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// Loader: prefer built build; fallback to tsx in dev
+import { createRequire } from 'module'
+import { fileURLToPath } from 'url'
+import { dirname, resolve } from 'path'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const dist = resolve(__dirname, '../dist/main.js')
+const src = resolve(__dirname, '../src/main.ts')
+const require = createRequire(import.meta.url)
+
+const { existsSync } = require('fs')
+
+if (existsSync(dist)) {
+  await import(dist)
+} else {
+  // Dev fallback
+  await import('tsx/esm')
+  await import(src)
+}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/main.js

@@ -0,0 +1,31 @@
+import{runMain as Ft}from"citty";import{defineCommand as Ot}from"citty";import{defineCommand as ft}from"citty";import{fileURLToPath as ct}from"url";import{dirname as dt,resolve as N}from"path";import{promises as U}from"fs";import*as L from"os";import{accessSync as Fe}from"fs";import*as Le from"toml";import*as p from"@clack/prompts";import{which as G,$ as x}from"zx";import rt from"fs-extra";import*as re from"path";import*as De from"os";import{createWriteStream as Ke}from"fs";function de(e){let t=null;try{t=Ke(e,{flags:"a"})}catch{}let o=(i,n)=>{let r=i?`${i} ${n}
+`:`${n}
+`;process.stdout.write(r),t&&t.write(r)};return{log:i=>o("",i),info:i=>o("",i),ok:i=>o("\u2714",i),warn:i=>o("\u26A0",i),err:i=>o("\u2716",i)}}import{$ as F}from"zx";import{which as Ye}from"zx";import{spawn as Qe}from"child_process";async function d(e){try{return await Ye(e),!0}catch{return!1}}async function ue(){return await d("brew")?"brew":await d("apt-get")?"apt":await d("dnf")?"dnf":await d("pacman")?"pacman":await d("zypper")?"zypper":"none"}async function m(e,t,o={dryRun:!1}){if(o.dryRun){let n=[e,...t].map(r=>r.includes(" ")?`"${r}"`:r).join(" ");o.logger?.log(`[dry-run] ${n}`);return}let i=Qe(e,t,{stdio:"inherit",cwd:o.cwd||process.cwd(),shell:!1});await new Promise((n,r)=>{i.on("error",r),i.on("exit",s=>{if(s===0)return n();r(new Error(`Command failed (${s}): ${e} ${t.join(" ")}`))})})}function D(e){let t=new Date().toISOString().replace(/[:.]/g,"-").slice(0,-5);return`${e}.backup.${t}`}import ge from"fs-extra";import*as q from"path";import*as W from"os";async function me(e){let t=await d("node"),o=await d("npm");if(t&&o){let n=(await F`node -v`).stdout.trim();e.logger.ok(`Node.js present (${n})`);return}switch(e.options.installNode){case"nvm":await Ze(e);break;case"brew":await et(e);break;case"skip":e.logger.warn("Skipping Node installation; please install Node 18+ manually");return}if(await d("node")){let n=(await F`node -v`).stdout.trim();e.logger.ok(`Node.js installed (${n})`)}else throw e.logger.err("Node installation failed"),new Error("Node.js installation failed")}async function Ze(e){if(e.logger.info("Installing Node.js via nvm"),e.options.dryRun){e.logger.log("[dry-run] install nvm + Node LTS");return}let t=q.join(e.homeDir,".nvm"),o=q.join(t,"nvm.sh");await ge.pathExists(t)||(e.logger.info("Installing nvm..."),await F`bash -c "curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash"`);let i=`export NVM_DIR="${t}" && [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" && nvm install --lts`;await F`bash -c ${i}`}async function et(e){if(e.logger.info("Installing Node.js via Homebrew"),!await d("brew"))if(W.platform()==="darwin"){if(e.logger.info("Homebrew not found; installing Homebrew"),e.options.dryRun){e.logger.log("[dry-run] install Homebrew");return}await F`/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`;let t=W.platform()==="darwin"&&W.arch()==="arm64"?"/opt/homebrew/bin/brew":"/usr/local/bin/brew";if(await ge.pathExists(t)){let o=q.dirname(t);process.env.PATH=`${o}:${process.env.PATH||""}`;try{let n=(await F`${t} shellenv`).stdout.trim().match(/export PATH="([^"]+)"/);n&&(process.env.PATH=`${n[1]}:${process.env.PATH||""}`)}catch{}}}else throw new Error("Homebrew is only available on macOS");await m("brew",["install","node"],{dryRun:e.options.dryRun,logger:e.logger})}import{$ as oe}from"zx";var tt=["@openai/codex","@ast-grep/cli"];async function we(e){e.logger.info("Checking global npm packages (@openai/codex, @ast-grep/cli)");let t=[];for(let o of tt)try{let n=(await oe`npm view ${o} version`.quiet()).stdout.trim();if(!n){e.logger.warn(`Could not fetch latest version for ${o}; skipping upgrade check`);continue}let r=await oe`npm ls -g ${o} --depth=0 --json`.quiet().nothrow(),s="";try{s=JSON.parse(r.stdout||"{}").dependencies?.[o]?.version||""}catch{s=""}s?s!==n?(e.logger.info(`${o} ${s} -> ${n}`),t.push(`${o}@${n}`)):e.logger.ok(`${o} up-to-date (${s})`):(e.logger.info(`${o} not installed; will install @${n}`),t.push(`${o}@${n}`))}catch(i){e.logger.warn(`Error checking ${o}: ${i}`);let n=await oe`npm ls -g ${o} --depth=0 --json`.quiet().nothrow(),r="";try{r=JSON.parse(n.stdout||"{}").dependencies?.[o]?.version||""}catch{r=""}r||t.push(o)}t.length>0?(e.logger.info("Installing/updating global npm packages"),await m("npm",["install","-g",...t],{dryRun:e.options.dryRun,logger:e.logger})):e.logger.ok("Global npm packages are up-to-date"),await d("codex")?e.logger.ok("Codex CLI installed"):e.logger.err("Codex CLI not found after install"),await d("ast-grep")?e.logger.ok("ast-grep installed"):e.logger.warn("ast-grep not found; check npm global path")}import{$ as ot}from"zx";import*as ie from"path";import ne from"fs-extra";var nt={brew:["fd","ripgrep","fzf","jq","yq","difftastic"],apt:["ripgrep","fzf","jq","yq","git-delta"],dnf:["ripgrep","fd-find","fzf","jq","yq","git-delta"],pacman:["ripgrep","fd","fzf","jq","yq","git-delta"],zypper:["ripgrep","fd","fzf","jq","yq","git-delta"],none:[]};async function he(e){let t=await ue();if(e.logger.info(`Detected package manager: ${t}`),t==="none"){e.logger.warn("Could not detect a supported package manager; please install tools manually");return}let o=nt[t]||[];if(o.length>0)switch(t){case"brew":await m("brew",["update"],{dryRun:e.options.dryRun,logger:e.logger}),await m("brew",["install",...o],{dryRun:e.options.dryRun,logger:e.logger});break;case"apt":await m("sudo",["apt-get","update","-y"],{dryRun:e.options.dryRun,logger:e.logger}),await m("sudo",["apt-get","install","-y",...o],{dryRun:e.options.dryRun,logger:e.logger}).catch(()=>{}),await d("fd")||await m("sudo",["apt-get","install","-y","fd-find"],{dryRun:e.options.dryRun,logger:e.logger}).catch(()=>{});break;case"dnf":await m("sudo",["dnf","install","-y",...o],{dryRun:e.options.dryRun,logger:e.logger}).catch(()=>{});break;case"pacman":await m("sudo",["pacman","-Sy","--noconfirm",...o],{dryRun:e.options.dryRun,logger:e.logger}).catch(()=>{});break;case"zypper":await m("sudo",["zypper","refresh"],{dryRun:e.options.dryRun,logger:e.logger}),await m("sudo",["zypper","install","-y",...o],{dryRun:e.options.dryRun,logger:e.logger}).catch(()=>{});break}if(!await d("difft")&&!await d("difftastic")&&(await d("cargo")?(e.logger.info("Installing difftastic via cargo"),await m("cargo",["install","difftastic"],{dryRun:e.options.dryRun,logger:e.logger})):e.logger.warn("difftastic not found and Rust/cargo missing; falling back to git-delta")),await d("fdfind")&&!await d("fd")){let n=ie.join(e.homeDir,".local","bin");await ne.ensureDir(n);let r=(await ot`command -v fdfind`).stdout.trim(),s=ie.join(n,"fd");await ne.pathExists(s)||(e.options.dryRun?e.logger.log(`[dry-run] ln -s ${r} ${s}`):await ne.symlink(r,s),e.logger.ok("fd alias created at ~/.local/bin/fd"))}let i=["fd","fdfind","rg","fzf","jq","yq","difft","difftastic","delta","ast-grep"];for(let n of i)await d(n)&&e.logger.ok(`${n} \u2713`)}import I from"fs-extra";import*as B from"path";async function be(e){let t=B.join(e.homeDir,".codex","config.toml"),o=B.join(e.rootDir,"templates","codex-config.toml");if(await I.ensureDir(B.dirname(t)),!await I.pathExists(o))throw e.logger.err(`Unified config template missing at ${o}`),new Error(`Template not found: ${o}`);if(!await I.pathExists(t)){e.logger.info(`Creating unified Codex config with multiple profiles at ${t}`),e.options.dryRun?e.logger.log(`[dry-run] cp ${o} ${t}`):await I.copy(o,t),e.logger.ok("Created ~/.codex/config.toml"),await ye(t,e.options.profile,e),e.logger.info("Tip: use 'codex --profile <name>' to switch at runtime or 'codex-1up config set-profile <name>' to persist.");return}e.logger.warn("~/.codex/config.toml already exists");let i=e.options.overwriteConfig;if(i==="no"){e.logger.info("Keeping existing config unchanged");return}let n=!1;if(i==="yes")n=!0;else if(!e.options.assumeYes&&!e.options.skipConfirmation){n=!1,e.logger.info("Keeping existing config; you can manage profiles via the new CLI later.");return}if(n){let r=D(t);e.options.dryRun?e.logger.log(`[dry-run] cp ${t} ${r}`):await I.copy(t,r),e.logger.info(`Backed up to ${r}`),e.options.dryRun?e.logger.log(`[dry-run] cp ${o} ${t}`):await I.copy(o,t),e.logger.ok("Overwrote ~/.codex/config.toml with unified template"),await ye(t,e.options.profile,e)}}async function ye(e,t,o){if(o.logger.info(`Setting active profile to: ${t}`),o.options.dryRun){o.logger.log(`[dry-run] set profile = "${t}" in ${e}`);return}let n=(await I.readFile(e,"utf8")).split(`
+`),r=!1,s=n.map(a=>/^\s*profile\s*=/.test(a)?(r=!0,`profile = "${t}"`):a);r||s.unshift(`profile = "${t}"`),await I.writeFile(e,s.join(`
+`),"utf8")}import E from"fs-extra";import*as _ from"path";async function $e(e){let t=_.join(e.homeDir,".codex","notify.sh"),o=_.join(e.rootDir,"templates","notification.sh");await E.ensureDir(_.dirname(t));let i=e.options.notify;if(i==="no"){e.logger.info("Skipping notify hook installation");return}if(!await E.pathExists(o)){e.logger.warn(`Notification template missing at ${o}; skipping notify hook install`);return}if(await E.pathExists(t))if(i==="yes"){let r=D(t);e.options.dryRun?e.logger.log(`[dry-run] cp ${t} ${r}`):await E.copy(t,r),e.options.dryRun?e.logger.log(`[dry-run] cp ${o} ${t}`):(await E.copy(o,t),await E.chmod(t,493)),e.logger.ok("Updated notify hook (backup created)")}else!e.options.assumeYes&&!e.options.skipConfirmation&&e.logger.info("Keeping existing notify hook");else e.options.dryRun?e.logger.log(`[dry-run] cp ${o} ${t}`):(await E.copy(o,t),await E.chmod(t,493)),e.logger.ok("Installed notify hook to ~/.codex/notify.sh");let n=_.join(e.homeDir,".codex","config.toml");await E.pathExists(n)?await it(n,t,e):e.logger.warn(`Config not found at ${n}; run again after config is created`)}async function it(e,t,o){if(o.options.dryRun){o.logger.log("[dry-run] update config notify and tui.notifications");return}let n=(await E.readFile(e,"utf8")).split(/\r?\n/),r="",s=null,a=null,c=!1,R=!1;for(let l=0;l<n.length;l++){let f=n[l],k=f.match(/^\s*\[([^\]]+)\]\s*$/);if(k){r=k[1],r==="tui"&&(a=l);continue}let g=/^\s*notify\s*=\s*\[/.test(f),A=/^\s*tui\.notifications\s*=/.test(f),j=/^\s*notifications\s*=/.test(f);g&&(r===""?s===null&&(s=l):/^profiles\.[^.]+\.features$/.test(r)&&(n.splice(l,1),l--,c=!0)),A&&/^profiles\.[^.]+\.features$/.test(r)&&(n.splice(l,1),l--,R=!0),j&&r===""&&(n.splice(l,1),l--,R=!0)}function $(l){let f=0;for(;f<n.length&&/^\s*(#.*)?$/.test(n[f]);)f++;n.splice(f,0,l)}if(s!==null){let l=n[s].match(/^(\s*notify\s*=\s*\[)([^\]]*)\]/);if(l){let f=l[2].trim();if(!f.includes(JSON.stringify(t))){let g=f&&!f.endsWith(",")?", ":"";n[s]=`${l[1]}${f}${g}${JSON.stringify(t)}]`,o.logger.ok("Added notify hook to config")}}}else $(`notify = [${JSON.stringify(t)}]`),o.logger.ok("Enabled notify hook in config");let w=!1;if(a!==null){let l=a+1,f=!1;for(;l<n.length;l++){let k=n[l];if(/^\s*\[/.test(k))break;if(/^\s*notifications\s*=/.test(k)){n[l]="notifications = true",f=!0,w=!0;break}}f||(n.splice(a+1,0,"notifications = true"),w=!0)}w||$(`[tui]
+notifications = true`);let S=[];r="";for(let l=0;l<n.length;l++){let f=n[l],k=f.match(/^\s*\[([^\]]+)\]\s*$/);if(k){r=k[1],S.push(f);continue}/^\s*tui\.notifications\s*=/.test(f)||/^\s*notifications\s*=/.test(f)&&r!=="tui"||S.push(f)}await E.writeFile(e,S.join(`
+`),"utf8")}import v from"fs-extra";import*as u from"path";async function Ce(e){let t=u.join(e.rootDir,"sounds"),o=u.join(e.homeDir,".codex","sounds");await v.ensureDir(o);let i=e.options.notificationSound;if(i==="none"){let w=await ke(e);e.options.dryRun?e.logger.log(`[dry-run] update ${w}`):await ve(w,`# Notification sound (disabled)
+export CODEX_DISABLE_SOUND=1
+export CODEX_CUSTOM_SOUND=""
+`,e);let l=u.join(e.homeDir,".codex","notify.sh");if(await v.pathExists(l)){let f=await v.readFile(l,"utf8"),k=f.replace(/^DEFAULT_CODEX_SOUND=.*$/m,'DEFAULT_CODEX_SOUND=""');e.options.dryRun?e.logger.log(`[dry-run] patch ${l} DEFAULT_CODEX_SOUND -> empty`):k!==f&&await v.writeFile(l,k,"utf8")}e.logger.ok("Notification sound disabled");return}let n;if(i&&!u.isAbsolute(i)?n=u.join(t,i):i?n=i:e.options.mode==="recommended"&&(n=u.join(t,"noti_1.wav")),!n||!await v.pathExists(n)){e.logger.warn("No notification sound selected or file missing; skipping sound setup");return}let r=u.isAbsolute(n),s=n.startsWith(u.join(e.rootDir,"sounds")),a=!r||s?u.join(o,u.basename(n)):n;(!r||s)&&(e.options.dryRun?e.logger.log(`[dry-run] cp ${n} ${a}`):await v.copy(n,a));let c=await ke(e),R=`# Notification sound
+export CODEX_DISABLE_SOUND=0
+export CODEX_CUSTOM_SOUND="${a}"
+`;e.options.dryRun?e.logger.log(`[dry-run] update ${c}`):await ve(c,R,e),e.logger.ok("Notification sound configured. Open a new shell or source your rc to apply.");let $=u.join(e.homeDir,".codex","notify.sh");if(await v.pathExists($)){let w=await v.readFile($,"utf8"),S=`DEFAULT_CODEX_SOUND="${a}"`,l=w.replace(/^DEFAULT_CODEX_SOUND=.*$/m,S);l!==w&&(e.options.dryRun?e.logger.log(`[dry-run] patch ${$} DEFAULT_CODEX_SOUND -> ${a}`):await v.writeFile($,l,"utf8"))}}async function ke(e){let t=e.options.shell||process.env.SHELL||"",o="auto";switch(o==="auto"&&(t.includes("zsh")?o="zsh":t.includes("fish")?o="fish":o="bash"),o){case"zsh":return u.join(e.homeDir,".zshrc");case"fish":return u.join(e.homeDir,".config","fish","config.fish");default:return u.join(e.homeDir,".bashrc")}}async function ve(e,t,o){let i="codex-1up";await v.ensureDir(u.dirname(e));let n="";if(await v.pathExists(e)){n=await v.readFile(e,"utf8");let s=`>>> ${i} >>>`,a=`<<< ${i} <<<`,c=new RegExp(`${s}[\\s\\S]*?${a}\\n?`,"g");n=n.replace(c,"")}let r=`>>> ${i} >>>
+${t}<<< ${i} <<<
+`;await v.writeFile(e,n+r,"utf8")}import C from"fs-extra";import*as P from"path";async function Se(e){let t=P.join(e.homeDir,".codex","AGENTS.md"),o=e.options.globalAgents;if(o==="skip"){e.logger.info("Skipping global AGENTS.md creation");return}let i=P.join(e.rootDir,"templates","agent-templates","AGENTS-default.md");if(!await C.pathExists(i)){e.logger.warn(`Template not found at ${i}`);return}switch(o){case"create-default":if(await C.pathExists(t)){e.logger.info("Global AGENTS.md already exists; leaving unchanged");return}await C.ensureDir(P.dirname(t)),e.options.dryRun?e.logger.log(`[dry-run] cp ${i} ${t}`):await C.copy(i,t),e.logger.ok(`Wrote ${t}`);break;case"overwrite-default":if(await C.ensureDir(P.dirname(t)),await C.pathExists(t)){let r=D(t);e.options.dryRun?e.logger.log(`[dry-run] cp ${t} ${r}`):await C.copy(t,r),e.logger.info(`Backed up existing AGENTS.md to: ${r}`)}e.options.dryRun?e.logger.log(`[dry-run] cp ${i} ${t}`):await C.copy(i,t),e.logger.ok(`Wrote ${t}`);break;case"append-default":if(await C.ensureDir(P.dirname(t)),await C.pathExists(t)){let r=D(t);e.options.dryRun?e.logger.log(`[dry-run] cp ${t} ${r}`):await C.copy(t,r),e.logger.info(`Backed up existing AGENTS.md to: ${r}`)}let n=await C.readFile(i,"utf8");e.options.dryRun?e.logger.log(`[dry-run] append template to ${t}`):await C.appendFile(t,`
+---
+
+${n}`,"utf8"),e.logger.ok(`Appended template to ${t}`);break;default:e.options.skipConfirmation&&e.logger.info("Skipping global AGENTS.md creation (non-interactive mode)");break}}async function Re(e){if(e.options.noVscode)return;let t=e.options.vscodeId;if(!t){e.logger.info("VS Code extension id not provided. Use: --vscode <publisher.extension>");return}if(!await d("code")){e.logger.warn("'code' (VS Code) not in PATH; skipping extension install");return}if(e.options.dryRun){e.logger.log(`[dry-run] code --install-extension ${t}`);return}e.logger.info(`Installing VS Code extension: ${t}`),await m("code",["--install-extension",t,"--force"],{dryRun:!1,logger:e.logger}),e.logger.ok(`VS Code extension '${t}' installed (or already present)`)}import V from"fs-extra";import*as z from"path";async function Ee(e){let t=e.options.agentsMd;if(!t)return;let o=t;(await V.stat(o).catch(()=>null))?.isDirectory()&&(o=z.join(o,"AGENTS.md"));let i=z.join(e.rootDir,"templates","agent-templates","AGENTS-default.md");if(await V.pathExists(o)){e.logger.warn(`${o} already exists`);let n=D(o);e.options.dryRun?e.logger.log(`[dry-run] cp ${o} ${n}`):await V.copy(o,n),e.logger.info(`Backed up existing AGENTS.md to: ${n}`)}e.logger.info(`Writing starter AGENTS.md to: ${o}`),e.options.dryRun?e.logger.log(`[dry-run] write AGENTS.md to ${o}`):(await V.ensureDir(z.dirname(o)),await V.copy(i,o),e.logger.ok("Wrote AGENTS.md"))}var Ne="codex-1up";async function ae(e,t){let o=De.homedir(),i=re.join(o,`.${Ne}`);await rt.ensureDir(i);let n=new Date().toISOString().replace(/[:.]/g,"-").slice(0,-5),r=re.join(i,`install-${n}.log`),s=de(r);s.info(`==> ${Ne} installer`),s.info(`Log: ${r}`);let a={cwd:process.cwd(),homeDir:o,rootDir:t,logDir:i,logFile:r,options:e,logger:s};try{await me(a),await we(a),await he(a),await be(a),await $e(a),await Ce(a),await Se(a),await Re(a),await Ee(a),s.ok("All done. Open a new shell or 'source' your rc file to load aliases."),s.info("Next steps:"),s.info("  1) codex    # sign in; then ask it to plan a refactor"),s.info("  2) ./bin/codex-1up agents --path $PWD   # write a starter AGENTS.md to your repo"),s.info("  3) Review ~/.codex/config.toml (see: https://github.com/openai/codex/blob/main/docs/config.md)")}catch(c){throw s.err(`Installation failed: ${c}`),c}}import{defineCommand as Q}from"citty";import{promises as H}from"fs";import{resolve as T,dirname as je}from"path";import{fileURLToPath as at}from"url";import{accessSync as Ie}from"fs";import st from"os";var Pe=je(at(import.meta.url));function lt(){let e=T(Pe,"../../"),t=T(Pe,"../../..");try{return Ie(T(e,"templates")),e}catch{}try{return Ie(T(t,"templates")),t}catch{}return t}var pt=lt();function se(){let e=T(st.homedir(),".codex"),t=T(e,"config.toml");return{CODEX_HOME:e,CFG:t}}async function le(e){return H.readFile(e,"utf8")}async function Te(e,t){await H.mkdir(je(e),{recursive:!0}),await H.writeFile(e,t,"utf8")}function Ae(e){let t=/^\[profiles\.(.+?)\]/gm,o=[],i;for(;i=t.exec(e);)o.push(i[1]);return o}function pe(e,t){let o=`profile = "${t}"`;if(/^profile\s*=\s*".*"/m.test(e))return e.replace(/^profile\s*=\s*".*"/m,o);let i=e.indexOf(`
+`);return i===-1?o+`
+`+e:e.slice(0,i+1)+o+`
+`+e.slice(i+1)}var Oe=Q({meta:{name:"config",description:"Manage Codex config profiles"},subCommands:{init:Q({meta:{name:"init",description:"Install unified config with multiple profiles"},args:{force:{type:"boolean",description:"Backup and overwrite if exists"}},async run({args:e}){let t=T(pt,"templates/codex-config.toml"),o=await le(t),{CFG:i}=se(),n=await H.access(i).then(()=>!0).catch(()=>!1);if(n&&!e.force){process.stdout.write(`${i} exists. Use --force to overwrite.
+`);return}if(n){let r=`${i}.backup.${Date.now()}`;await H.copyFile(i,r),process.stdout.write(`Backed up to ${r}
+`)}await Te(i,o),process.stdout.write(`Wrote ${i}
+`)}}),profiles:Q({meta:{name:"profiles",description:"List profiles in the current config"},async run(){let{CFG:e}=se(),t=await le(e),o=Ae(t);process.stdout.write(o.length?o.join(`
+`)+`
+`:`No profiles found
+`)}}),"set-profile":Q({meta:{name:"set-profile",description:"Set the active profile in config.toml"},args:{name:{type:"positional",required:!0,description:"Profile name"}},async run({args:e}){let{CFG:t}=se(),o=await le(t),i=Ae(o),n=String(e.name);if(!i.includes(n))throw new Error(`Unknown profile: ${n}`);let r=pe(o,n);await Te(t,r),process.stdout.write(`profile set to ${n}
+`)}})}});var _e=dt(ct(import.meta.url));function ut(){let e=N(_e,"../../"),t=N(_e,"../../..");try{return Fe(N(e,"templates")),e}catch{}try{return Fe(N(t,"templates")),t}catch{}return t}var Z=ut(),Ue=ft({meta:{name:"install",description:"Run the codex-1up installer with validated flags"},args:{yes:{type:"boolean",description:"Non-interactive; accept safe defaults"},"dry-run":{type:"boolean",description:"Print actions without making changes"},"skip-confirmation":{type:"boolean",description:"Skip prompts"},shell:{type:"string",description:"auto|zsh|bash|fish"},vscode:{type:"string",description:"Install VS Code extension id"},"no-vscode":{type:"boolean",description:"Skip VS Code extension checks"},"git-external-diff":{type:"boolean",description:"Set difftastic as git external diff"},"install-node":{type:"string",description:"nvm|brew|skip"},"agents-md":{type:"string",description:"Write starter AGENTS.md to PATH (default PWD/AGENTS.md)",required:!1}},async run({args:e}){let t=N(L.homedir(),".codex","config.toml"),o=await fe(t),i=N(L.homedir(),".codex","notify.sh"),n=await fe(i),r=N(L.homedir(),".codex","AGENTS.md"),s=await fe(r),a,c=!o,R=process.stdout.isTTY&&!e["dry-run"]&&!e["skip-confirmation"]&&!e.yes,$="balanced",w,S,l;if(R){if(p.intro("codex-1up \xB7 Install"),o){let g=await p.confirm({message:"Overwrite existing ~/.codex/config.toml with the latest template? (backup will be created)",initialValue:!0});if(p.isCancel(g))return p.cancel("Install aborted");a=g?"yes":"no",c=g,g||p.log.info("Keeping existing config (no overwrite).")}{let ee=function(b){return[{label:"Skip (leave current setup)",value:"skip"},{label:"None (disable sounds)",value:"none"},...j.map(h=>({label:h,value:h})),{label:"Custom path\u2026",value:"custom"}]};var k=ee;let g=await p.select({message:"Active profile",options:[{label:"balanced (default)",value:"balanced"},{label:"safe",value:"safe"},{label:"minimal",value:"minimal"},{label:"yolo (risky)",value:"yolo"}],initialValue:"balanced"});if(p.isCancel(g))return p.cancel("Install aborted");$=g;let A=N(Z,"sounds"),j=[];try{j=(await U.readdir(A)).filter(b=>/\.(wav|mp3|ogg)$/i.test(b)).sort()}catch{}w="yes";let y=j.includes("noti_1.wav")?"noti_1.wav":j[0]||"none";async function te(b){let h=await p.text({message:"Enter absolute path to a .wav file",placeholder:b||"/absolute/path/to/sound.wav",validate(O){if(!O)return"Path required";if(!O.startsWith("/"))return"Use an absolute path";if(!/(\.wav|\.mp3|\.ogg)$/i.test(O))return"Supported: .wav, .mp3, .ogg"}});if(p.isCancel(h))return null;try{await U.access(String(h))}catch{return p.log.warn("File not found. Try again."),await te(String(h))}return String(h)}let M=await p.select({message:"Notification sound",options:ee(y),initialValue:y});if(p.isCancel(M))return p.cancel("Install aborted");if(M==="skip")w="no",l=void 0;else if(M==="custom"){let b=await te();if(b===null)return p.cancel("Install aborted");y=b}else y=M;if(M!=="skip"){for(;;){let b=await p.select({message:`Selected: ${y}. What next?`,options:[{label:"Preview \u25B6 (press p then Enter)",value:"preview"},{label:"Use this",value:"use"},{label:"Choose another\u2026",value:"change"}],initialValue:"use"});if(p.isCancel(b))return p.cancel("Install aborted");if(b==="use")break;if(b==="change"){let h=await p.select({message:"Notification sound",options:ee(y),initialValue:y});if(p.isCancel(h))return p.cancel("Install aborted");if(h==="custom"){let O=await te();if(O===null)return p.cancel("Install aborted");y=O}else if(h==="skip"){w="no",l=void 0;break}else y=h;continue}try{let h=y==="none"?"none":y.startsWith("/")?y:N(Z,"sounds",y);await gt(h)}catch(h){p.log.warn(String(h))}}l===void 0&&(l=y)}if(s){let b=await p.select({message:"Global ~/.codex/AGENTS.md",options:[{label:"Add to your existing AGENTS.md (Backup will be created)",value:"append-default"},{label:"Overwrite existing (Backup will be created)",value:"overwrite-default"},{label:"Skip \u2014 leave as-is",value:"skip"}],initialValue:"append-default"});if(p.isCancel(b))return p.cancel("Install aborted");S=b}else S="skip"}}let f={profile:$,overwriteConfig:a,notify:w,globalAgents:S,notificationSound:l,mode:"manual",installNode:e["install-node"]||"nvm",shell:String(e.shell||"auto"),vscodeId:e.vscode?String(e.vscode):void 0,noVscode:e["no-vscode"]||!1,agentsMd:typeof e["agents-md"]<"u"?String(e["agents-md"]||process.cwd()):void 0,dryRun:e["dry-run"]||!1,assumeYes:e.yes||!1,skipConfirmation:e["skip-confirmation"]||!1};if(R){let g=p.spinner();g.start("Installing prerequisites and writing config");try{await ae(f,Z),g.stop("Base install complete"),c?await mt($):p.log.info("Profile unchanged (existing config kept)."),p.outro("Install finished")}catch(A){throw g.stop("Installation failed"),p.cancel(`Installation failed: ${A}`),A}await Ge();return}try{R||(a=o?"no":a,c=!1,w=n?"no":"yes",S="skip",f.overwriteConfig=a,f.notify=w,f.globalAgents=S,f.notificationSound=l),await ae(f,Z),await Ge()}catch(g){throw p.cancel(`Installation failed: ${g}`),g}}});async function Ge(){let e=L.homedir(),t=N(e,".codex","config.toml"),o,i=[];try{let c=await U.readFile(t,"utf8"),R=Le.parse(c);o=R.profile;let $=R.profiles||{};i=Object.keys($)}catch{}let n=["codex","ast-grep","fd","rg","fzf","jq","yq","difft","difftastic"],s=(await Promise.all(n.map(async c=>{try{return await G(c),[c,!0]}catch{return[c,!1]}}))).filter(([,c])=>c).map(([c])=>c),a=[];a.push(""),a.push("codex-1up: Installation summary"),a.push("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"),a.push(`Config: ${t}${o?` (active profile: ${o})`:""}`),i.length&&a.push(`Profiles: ${i.join(", ")}`),a.push(`Tools detected: ${s.join(", ")||"none"}`),a.push(""),a.push("Usage:"),a.push("  - Switch profile for a session:  codex --profile <name>"),a.push("  - List available profiles:       codex-1up config profiles"),a.push("  - Persist active profile:        codex-1up config set-profile <name>"),a.push("  - Write AGENTS.md to a repo:     codex-1up agents --path . --template default"),a.push(""),process.stdout.write(a.join(`
+`)+`
+`)}async function gt(e){if(e.endsWith("/none")||e==="none")return;let t=[async o=>{await G("afplay"),await x`afplay ${o}`},async o=>{await G("paplay"),await x`paplay ${o}`},async o=>{await G("aplay"),await x`aplay ${o}`},async o=>{await G("mpg123"),await x`mpg123 -q ${o}`},async o=>{await G("ffplay"),await x`ffplay -nodisp -autoexit -loglevel quiet ${o}`}];for(let o of t)try{await o(e);return}catch{}throw new Error("No audio player found (afplay/paplay/aplay/mpg123/ffplay)")}async function mt(e){let t=N(L.homedir(),".codex","config.toml");try{let o=await U.readFile(t,"utf8"),i=pe(o,e);await U.writeFile(t,i,"utf8")}catch{}}async function fe(e){try{return await U.access(e),!0}catch{return!1}}import{defineCommand as wt}from"citty";import{promises as J}from"fs";import{accessSync as ht}from"fs";import{resolve as X,dirname as qe}from"path";import{fileURLToPath as yt}from"url";var Me=qe(yt(import.meta.url));function bt(){let e=X(Me,"../../"),t=X(Me,"../../..");try{return ht(X(e,"templates")),e}catch{}return t}var $t=bt();async function ce(e){try{return await J.access(e),!0}catch{return!1}}async function kt(e,t){if(await ce(t)){let i=`${t}.backup.${new Date().toISOString().replace(/[:.]/g,"").replace("T","_").slice(0,15)}`;await J.copyFile(t,i)}await J.mkdir(qe(t),{recursive:!0}),await J.copyFile(e,t)}var We=wt({meta:{name:"agents",description:"Write an AGENTS.md template"},args:{path:{type:"string",required:!0,description:"Target repo path or file"}},async run({args:e}){let t=String(e.path),o=X($t,"templates/agent-templates","AGENTS-default.md"),n=await ce(t).then(async r=>r&&(await J.stat(t)).isDirectory()).catch(()=>!1)?X(t,"AGENTS.md"):t;if(!await ce(o))throw new Error(`Template not found: ${o}`);await kt(o,n),process.stdout.write(`Wrote ${n}
+`)}});import{defineCommand as vt}from"citty";import{$ as Ct}from"zx";import{fileURLToPath as St}from"url";import{accessSync as Be}from"fs";import{dirname as Rt,resolve as K}from"path";var Ve=Rt(St(import.meta.url));function Et(){let e=K(Ve,"../../"),t=K(Ve,"../../..");try{return Be(K(e,"templates")),e}catch{}try{return Be(K(t,"templates")),t}catch{}return t}var Nt=Et(),ze=vt({meta:{name:"doctor",description:"Run environment checks"},async run(){await Ct`bash ${K(Nt,"scripts/doctor.sh")}`}});import{defineCommand as Dt}from"citty";import{$ as It}from"zx";import{fileURLToPath as Pt}from"url";import{accessSync as He}from"fs";import{dirname as Tt,resolve as Y}from"path";var xe=Tt(Pt(import.meta.url));function At(){let e=Y(xe,"../../"),t=Y(xe,"../../..");try{return He(Y(e,"templates")),e}catch{}try{return He(Y(t,"templates")),t}catch{}return t}var jt=At(),Je=Dt({meta:{name:"uninstall",description:"Clean up aliases and config created by this tool"},async run(){await It`bash ${Y(jt,"scripts/uninstall.sh")}`}});var Xe=Ot({meta:{name:"codex-1up",version:"0.1.0",description:"Power up Codex CLI with clean profiles config and helpers"},subCommands:{install:Ue,agents:We,doctor:ze,uninstall:Je,config:Oe}});Ft(Xe);

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "codex-1up",
+  "private": false,
+  "type": "module",
+  "version": "0.1.1",
+  "description": "TypeScript CLI for codex-1up (citty-based)",
+  "bin": {
+    "codex-1up": "bin/codex-1up.mjs"
+  },
+  "dependencies": {
+    "citty": "^0.1.6",
+    "toml": "^3.0.0",
+    "@clack/prompts": "^0.11.0",
+    "zx": "^8.1.7",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.0",
+    "@types/fs-extra": "^11.0.4",
+    "eslint": "^9.12.0",
+    "prettier": "^3.3.3",
+    "tsup": "^8.3.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3",
+    "vitest": "^4.0.8"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "LICENSE",
+    "templates",
+    "bin",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/regenrek/codex-1up.git"
+  },
+  "license": "MIT",
+  "keywords": [
+    "codex",
+    "openai",
+    "cli",
+    "developer-tools"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup src/main.ts --format esm --dts --minify --clean --out-dir dist",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "coverage": "vitest run --coverage"
+  }
+}

package/scripts/doctor.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+need() { command -v "$1" >/dev/null 2>&1; }
+check() { if need "$1"; then echo "✔ $1"; else echo "✖ $1 (missing)"; fi }
+
+echo "codex-1up doctor"
+echo "--- binaries ---"
+for c in node npm codex ast-grep fd fdfind rg fzf jq yq difft delta code; do
+  check "$c"
+done
+
+echo "--- git ---"
+echo "diff.external = $(git config --global --get diff.external || echo "(none)")"
+echo "difftool.difftastic.cmd = $(git config --global --get difftool.difftastic.cmd || echo "(none)")"
+echo "core.pager = $(git config --global --get core.pager || echo "(none)")"
+
+echo "--- codex config ---"
+CFG="$HOME/.codex/config.toml"
+if [ -f "$CFG" ]; then
+  echo "found: $CFG"
+  if grep -Eiq '^\s*\[tools\]' "$CFG" && grep -Eiq '^\s*web_search\s*=\s*true' "$CFG"; then
+    echo "✔ tools.web_search = true"
+  else
+    echo "✖ tools.web_search not enabled"
+  fi
+else
+  echo "✖ ~/.codex/config.toml not found"
+fi
+
+echo "--- shell rc hints ---"
+echo "SHELL=$SHELL"
+for rc in "$HOME/.zshrc" "$HOME/.bashrc" "$HOME/.config/fish/config.fish"; do
+  [ -f "$rc" ] && grep -q ">>> codex-1up >>>" "$rc" && echo "Found codex-1up block in $rc"
+done
+
+echo "Done."

package/scripts/notification.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+payload="${1:-$(cat)}"
+
+# Default bundled sound path placeholder; installer should set CODEX_CUSTOM_SOUND.
+DEFAULT_CODEX_SOUND="${HOME}/.codex/sounds/default.wav"
+
+# Respect opt-out via env var
+if [ "${CODEX_DISABLE_SOUND:-0}" = "1" ]; then
+  exit 0
+fi
+
+# Resolve configured sound (absolute path recommended). Allow special value 'none'.
+CODEX_CUSTOM_SOUND="${CODEX_CUSTOM_SOUND:-$DEFAULT_CODEX_SOUND}"
+if [ -z "$CODEX_CUSTOM_SOUND" ] || [ "$CODEX_CUSTOM_SOUND" = "none" ]; then
+  exit 0
+fi
+
+# Choose an available audio player
+_pick_player() {
+  if command -v afplay >/dev/null 2>&1; then echo "afplay"; return 0; fi
+  if command -v paplay >/dev/null 2>&1; then echo "paplay"; return 0; fi
+  if command -v aplay  >/dev/null 2>&1; then echo "aplay";  return 0; fi
+  if command -v mpg123 >/dev/null 2>&1; then echo "mpg123"; return 0; fi
+  if command -v ffplay >/dev/null 2>&1; then echo "ffplay -nodisp -autoexit"; return 0; fi
+  echo ""
+}
+
+PLAYER_CMD=$(_pick_player)
+[ -n "$PLAYER_CMD" ] || exit 0
+
+# Only attempt to play if file exists
+if [ ! -f "$CODEX_CUSTOM_SOUND" ]; then
+  exit 0
+fi
+
+_play() {
+  # shellcheck disable=SC2086
+  $PLAYER_CMD "$CODEX_CUSTOM_SOUND" >/dev/null 2>&1 < /dev/null &
+}
+
+if command -v jq >/dev/null 2>&1; then
+  notification_type=$(printf '%s' "$payload" | jq -r '.type // empty')
+  case "$notification_type" in
+    "agent-turn-complete") _play ;;
+    *) : ;;
+  esac
+else
+  _play
+fi

package/scripts/release.ts

@@ -0,0 +1,198 @@
+import { execSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+
+interface PackageTarget {
+	name: string;
+	dir: string;
+	bump?: boolean;
+	publish?: boolean;
+	access?: "public" | "restricted";
+}
+
+const packageTargets: PackageTarget[] = [
+	{ name: "codex-1up", dir: "cli", bump: true, publish: true, access: "public" },
+];
+
+function run(command: string, cwd: string) {
+	console.log(`Executing: ${command} in ${cwd}`);
+	execSync(command, { stdio: "inherit", cwd });
+}
+
+function ensureCleanWorkingTree() {
+	const status = execSync("git status --porcelain", { cwd: "." })
+		.toString()
+		.trim();
+	if (status.length > 0) {
+		throw new Error(
+			"Working tree has uncommitted changes. Please commit or stash them before running the release script.",
+		);
+	}
+}
+
+/**
+ * Bump version in package.json
+ * @param pkgPath Path to the package directory
+ * @param type Version bump type: 'major', 'minor', 'patch', or specific version
+ * @returns The new version
+ */
+function bumpVersion(
+	pkgPath: string,
+	type: "major" | "minor" | "patch" | string,
+): string {
+	const pkgJsonPath = path.join(pkgPath, "package.json");
+	const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
+	const currentVersion = pkgJson.version;
+	let newVersion: string;
+
+	if (type === "major" || type === "minor" || type === "patch") {
+		// Parse current version
+		const [major, minor, patch] = currentVersion.split(".").map(Number);
+
+		// Bump version according to type
+		if (type === "major") {
+			newVersion = `${major + 1}.0.0`;
+		} else if (type === "minor") {
+			newVersion = `${major}.${minor + 1}.0`;
+		} else {
+			// patch
+			newVersion = `${major}.${minor}.${patch + 1}`;
+		}
+	} else {
+		// Use the provided version string directly
+		newVersion = type;
+	}
+
+	// Update package.json
+	pkgJson.version = newVersion;
+	fs.writeFileSync(pkgJsonPath, `${JSON.stringify(pkgJson, null, 2)}\n`);
+
+	console.log(
+		`Bumped version from ${currentVersion} to ${newVersion} in ${pkgJsonPath}`,
+	);
+	return newVersion;
+}
+
+/**
+ * Bump version in all package.json files
+ * @param versionBump Version bump type or specific version
+ * @returns The new version
+ */
+function bumpAllVersions(
+	versionBump: "major" | "minor" | "patch" | string = "patch",
+): string {
+	const target = packageTargets[0];
+	const pkgPath = path.resolve(target.dir);
+	return bumpVersion(pkgPath, versionBump);
+}
+
+/**
+ * Create a git commit and tag for the release
+ * @param version The version to tag
+ */
+function createGitCommitAndTag(version: string) {
+	console.log("Creating git commit and tag...");
+
+	try {
+		// Stage all changes
+		run("git add .", ".");
+
+		// Create commit with version message
+		run(`git commit -m "chore: release v${version}"`, ".");
+
+		// Create tag
+		run(`git tag -a v${version} -m "Release v${version}"`, ".");
+
+		// Push commit and tag to remote
+		console.log("Pushing commit and tag to remote...");
+		run("git push", ".");
+		run("git push --tags", ".");
+
+		console.log(`Successfully created and pushed git tag v${version}`);
+	} catch (error) {
+		console.error("Failed to create git commit and tag:", error);
+		throw error;
+	}
+}
+
+async function publishPackages(
+	versionBump: "major" | "minor" | "patch" | string = "patch",
+) {
+	ensureCleanWorkingTree();
+
+	const newVersion = bumpAllVersions(versionBump);
+
+	for (const target of packageTargets.filter((pkg) => pkg.publish)) {
+		const pkgPath = path.resolve(target.dir);
+		const manifestPath = path.join(pkgPath, "package.json");
+		if (!fs.existsSync(manifestPath)) {
+			console.warn(`Skipping publish for ${target.name}; missing ${manifestPath}`);
+			continue;
+		}
+		const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+		if (manifest.private) {
+			console.warn(
+				`Skipping publish for ${target.name}; package.json is marked private`,
+			);
+			continue;
+		}
+		// Install deps and build before publish
+			// Copy assets from repo root into package (ephemeral for packing only)
+			run("rm -rf templates scripts || true", pkgPath);
+			run("cp -R ../templates ./templates", pkgPath);
+			run("cp -R ../scripts ./scripts", pkgPath);
+
+		// Ensure README and LICENSE exist inside the package for npm UI
+		try {
+			const rootReadme = path.resolve(pkgPath, "../README.md");
+			if (fs.existsSync(rootReadme)) {
+				let readme = fs.readFileSync(rootReadme, "utf8");
+				// If README uses local ./public images, rewrite to absolute GitHub raw URLs
+				// Derive repo slug from package.json repository.url when possible
+				let repoSlug = "";
+				try {
+					const repoUrl: string | undefined = manifest?.repository?.url;
+					if (repoUrl) {
+						const m = repoUrl.match(/github\.com\/(.+?)\.git$/);
+						if (m) repoSlug = m[1];
+					}
+				} catch {}
+				if (repoSlug) {
+					readme = readme.replace(
+						/\]\(\.\/public\//g,
+						`] (https://raw.githubusercontent.com/${repoSlug}/main/public/`.replace(" ] ", "]"),
+					);
+				}
+				fs.writeFileSync(path.join(pkgPath, "README.md"), readme);
+			}
+			const rootLicense = path.resolve(pkgPath, "../LICENSE");
+			if (fs.existsSync(rootLicense)) {
+				fs.copyFileSync(rootLicense, path.join(pkgPath, "LICENSE"));
+			}
+		} catch (e) {
+			console.warn("Failed to prepare README/LICENSE in package:", e);
+		}
+
+		run("pnpm i --frozen-lockfile=false", pkgPath);
+		run("pnpm build", pkgPath);
+		const accessFlag = target.access === "public" ? " --access public" : "";
+		console.log(`Publishing ${target.name}@${newVersion}...`);
+		run(`pnpm publish --no-git-checks${accessFlag}`, pkgPath);
+
+		// Clean up ephemeral copies so repo doesn't keep duplicates
+		try {
+			fs.rmSync(path.join(pkgPath, "templates"), { recursive: true, force: true });
+			fs.rmSync(path.join(pkgPath, "scripts"), { recursive: true, force: true });
+			fs.rmSync(path.join(pkgPath, "README.md"), { force: true });
+			fs.rmSync(path.join(pkgPath, "LICENSE"), { force: true });
+		} catch {}
+	}
+
+	createGitCommitAndTag(newVersion);
+}
+
+// Get version bump type from command line arguments
+const args = process.argv.slice(2);
+const versionBumpArg = args[0] || "patch"; // Default to patch
+
+publishPackages(versionBumpArg).catch(console.error);

package/scripts/uninstall.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+PROJECT="codex-1up"
+echo "Uninstall: removing shell alias blocks and git config entries"
+
+remove_block() {
+  local rc="$1"
+  [ -f "$rc" ] || return 0
+  if grep -q ">>> ${PROJECT} >>>" "$rc"; then
+    # shellcheck disable=SC2016
+    sed -i.bak -e "/>>> ${PROJECT} >>>/,/<<< ${PROJECT} <</d" "$rc"
+    echo "Cleaned ${rc} (backup at ${rc}.bak)"
+  fi
+}
+
+remove_block "$HOME/.zshrc"
+remove_block "$HOME/.bashrc"
+remove_block "$HOME/.config/fish/config.fish"
+
+# Git settings (safe to leave, but we can remove)
+if [ "$(git config --global --get difftool.difftastic.cmd)" ]; then
+  git config --global --unset difftool.difftastic.cmd || true
+  git config --global --unset difftool.prompt || true
+  echo "Removed git difftastic difftool config"
+fi
+
+if [ "$(git config --global --get diff.external)" = "difft" ]; then
+  git config --global --unset diff.external || true
+  echo "Removed git diff.external=difft"
+fi
+
+echo "Note: packages (codex, fd, rg, ast-grep, difftastic, etc.) are not removed."
+echo "Uninstall complete."

package/templates/agent-templates/AGENTS-default.md

@@ -0,0 +1,22 @@
+# AGENTS.md — Tool Selection
+
+When you need to call tools from the shell, use this rubric:
+
+## File Operations
+- Use `fd` for finding files: `fd --full-path '<pattern>' | head -n 1`
+
+## Structured Code Search
+- Find code structure: `ast-grep --lang <language> -p '<pattern>'`
+- List matching files: `ast-grep -l --lang <language> -p '<pattern>' | head -n 10`
+- Prefer `ast-grep` over `rg`/`grep` when you need syntax-aware matching
+
+## Data Processing
+- JSON: `jq`
+- YAML/XML: `yq`
+
+## Selection
+- Select from multiple results deterministically (non-interactive filtering)
+- Fuzzy finder: `fzf --filter 'term' | head -n 1`
+
+## Guidelines
+- Prefer deterministic, non-interactive commands (`head`, `--filter`, `--json` + `jq`) so runs are reproducible

package/templates/codex-config.toml

@@ -0,0 +1,57 @@
+# ~/.codex/config.toml — created by codex-1up
+# Adjust to your liking. See Codex CLI docs for full options.
+
+# Core (root defaults)
+model = "gpt-5"
+approval_policy = "on-request"       # untrusted|on-failure|on-request|never
+sandbox_mode   = "workspace-write"   # read-only|workspace-write|danger-full-access
+profile = "balanced"                 # active profile: balanced|safe|minimal|yolo
+
+# Extra settings that only apply when `sandbox = "workspace-write"`.
+[sandbox_workspace_write]
+# Allow the command being run inside the sandbox to make outbound network
+# requests. Disabled by default.
+network_access = true
+
+# UI & notifications (can be toggled by installer)
+[tui]
+# Desktop notifications from the TUI: boolean or filtered list. Default: false
+# Examples: true | ["agent-turn-complete", "approval-requested"]
+notifications = false
+
+# Centralized feature flags — booleans only
+[features]
+web_search_request = true
+unified_exec = false
+streamable_shell = false
+rmcp_client = false
+apply_patch_freeform = false
+view_image_tool = true
+experimental_sandbox_command_assessment = false
+ghost_commit = false
+enable_experimental_windows_sandbox = false
+
+# ---- Profiles (override only what differs from root) -----------------------
+
+[profiles.balanced]
+approval_policy = "on-request"
+sandbox_mode = "workspace-write"
+[profiles.balanced.features]
+web_search_request = true
+
+[profiles.safe]
+approval_policy = "on-failure"
+sandbox_mode = "workspace-write"
+[profiles.safe.features]
+web_search_request = false
+
+[profiles.minimal]
+model_reasoning_effort = "minimal"
+[profiles.minimal.features]
+web_search_request = false
+
+[profiles.yolo]
+approval_policy = "never"
+sandbox_mode = "danger-full-access"
+[profiles.yolo.features]
+web_search_request = true

package/templates/notification.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# Codex notification hook — installed to ~/.codex/notify.sh by codex-1up
+# Reads JSON payload on stdin or as first arg. Plays a short sound for specific events.
+
+set -euo pipefail
+
+payload="${1:-$(cat)}"
+
+# Default bundled sound path; can be overridden via CODEX_CUSTOM_SOUND in your shell rc.
+DEFAULT_CODEX_SOUND="${HOME}/.codex/sounds/default.wav"
+
+# Respect opt-out via env var
+if [ "${CODEX_DISABLE_SOUND:-0}" = "1" ]; then
+  exit 0
+fi
+
+# Resolve configured sound (absolute path recommended). Allow special value 'none'.
+CODEX_CUSTOM_SOUND="${CODEX_CUSTOM_SOUND:-$DEFAULT_CODEX_SOUND}"
+if [ -z "$CODEX_CUSTOM_SOUND" ] || [ "$CODEX_CUSTOM_SOUND" = "none" ]; then
+  exit 0
+fi
+
+# Choose an available audio player
+_pick_player() {
+  if command -v afplay >/dev/null 2>&1; then echo "afplay"; return 0; fi
+  if command -v paplay >/dev/null 2>&1; then echo "paplay"; return 0; fi
+  if command -v aplay  >/dev/null 2>&1; then echo "aplay";  return 0; fi
+  if command -v mpg123 >/dev/null 2>&1; then echo "mpg123"; return 0; fi
+  if command -v ffplay >/dev/null 2>&1; then echo "ffplay -nodisp -autoexit"; return 0; fi
+  echo ""
+}
+
+PLAYER_CMD=$(_pick_player)
+[ -n "$PLAYER_CMD" ] || exit 0
+
+# Only attempt to play if file exists
+if [ ! -f "$CODEX_CUSTOM_SOUND" ]; then
+  exit 0
+fi
+
+_play() {
+  # shellcheck disable=SC2086
+  $PLAYER_CMD "$CODEX_CUSTOM_SOUND" >/dev/null 2>&1 < /dev/null &
+}
+
+if command -v jq >/dev/null 2>&1; then
+  notification_type=$(printf '%s' "$payload" | jq -r '.type // empty')
+  case "$notification_type" in
+    "agent-turn-complete") _play ;;
+    *) : ;;
+  esac
+else
+  _play
+fi