uv-suite 0.4.0 → 0.6.0

package/bin/cli.js

@@ -1,49 +1,52 @@
 #!/usr/bin/env node
 
-const { execSync } = require('child_process');
+const { execSync, spawn } = require('child_process');
 const path = require('path');
 const fs = require('fs');
 
 const UV_SUITE_DIR = path.resolve(__dirname, '..');
 const args = process.argv.slice(2);
 const command = args[0];
+const pkg = require(path.join(UV_SUITE_DIR, 'package.json'));
+
+const PERSONAS = ['spike', 'sport', 'pro', 'professional', 'auto'];
+const TOOLS = ['claude', 'codex'];
 
 function usage() {
   console.log(`
-  uv-suite - AI-assisted development framework
+  uv v${pkg.version} — AI-assisted development framework
 
-  Usage:
-    npx uv-suite install [--persona sport|professional|auto|spike] [--global]
-    npx uv-suite info
+  Launch a session:
+    uv claude pro          Claude Code, Professional persona
+    uv claude auto         Claude Code, Auto persona
+    uv codex pro           Codex, Professional persona
+    uv codex sport         Codex, Sport persona
+    uv pro                 Shorthand (defaults to Claude Code)
+    uv                     Claude Code, Professional
 
-  Commands:
-    install   Install agents, skills, hooks, guardrails, and personas
-    info      Show what would be installed
+  Setup:
+    uv install             Install UV Suite into current project
+    uv install --persona sport
+    uv info                Show what's installed
 
   Personas:
-    spike          Research & documentation (Opus, max effort)
-    sport          New projects, prototyping (Sonnet, high effort)
-    professional   Production code (default, all hooks + guardrails)
-    auto           Fully autonomous (max effort, everything approved)
-
-  Examples:
-    npx uv-suite install                        Install with Professional persona
-    npx uv-suite install --persona sport        Install with Sport persona
-    npx uv-suite install --global               Install to ~/.claude/
+    spike        Research & docs (Opus, max effort)
+    sport        New projects (Sonnet, high effort)
+    pro          Production code (all hooks, all guardrails)
+    auto         Fully autonomous (max effort, everything approved)
   `);
 }
 
 function info() {
   console.log(`
-  UV Suite v0.1.0
+  UV Suite v${pkg.version}
 
   Contents:
     10 agents      Claude Code (.md), Cursor (.mdc), Codex (.toml)
     9  skills      Slash commands for Claude Code
-    4  hooks       auto-lint, slop-check, danger-zone, block-destructive
-    6  guardrails  Anti-slop rules (comment, overengineering, error, test, doc, architecture)
+    5  hooks       auto-lint, slop-check, danger-zone, block-destructive, review-reminder
+    6  guardrails  Anti-slop rules
     4  personas    Spike, Sport, Professional, Auto
-    1  launcher    uv.sh (session launcher with persona selection)
 
   Source: ${UV_SUITE_DIR}
   `);
@@ -55,8 +58,6 @@ function install() {
     console.error('Error: install.sh not found at', installScript);
     process.exit(1);
   }
-
-  // Pass through all args after "install"
   const installArgs = args.slice(1).join(' ');
   try {
     execSync(`bash "${installScript}" ${installArgs}`, { stdio: 'inherit' });
@@ -65,20 +66,77 @@ function install() {
   }
 }
 
-switch (command) {
-  case 'install':
-    install();
-    break;
-  case 'info':
-    info();
-    break;
-  case '--help':
-  case '-h':
-  case undefined:
-    usage();
-    break;
-  default:
-    console.error(`Unknown command: ${command}`);
-    usage();
+function normPersona(p) {
+  if (p === 'pro' || p === 'professional') return 'professional';
+  if (PERSONAS.includes(p)) return p;
+  return null;
+}
+
+function personaLabel(p) {
+  const labels = {
+    spike: 'Spike — research & docs (Opus, max)',
+    sport: 'Sport — lightweight (Sonnet, high)',
+    professional: 'Professional — full rigor (all hooks, all guardrails)',
+    auto: 'Auto — autonomous (max, everything approved)',
+  };
+  return labels[p] || p;
+}
+
+function launchClaude(persona, extra) {
+  const settings = path.resolve('.claude/personas', `${persona}.json`);
+  if (!fs.existsSync(settings)) {
+    console.error(`Error: ${settings} not found. Run 'uv install' first.`);
+    process.exit(1);
+  }
+  console.log(`UV Suite | Claude Code | ${personaLabel(persona)}`);
+  console.log('');
+  const child = spawn('claude', ['--settings', settings, ...extra], { stdio: 'inherit' });
+  child.on('exit', (code) => process.exit(code || 0));
+}
+
+function launchCodex(persona, extra) {
+  const approvalMap = {
+    spike: ['--model', 'o3', '--approval-mode', 'suggest'],
+    sport: ['--approval-mode', 'auto-edit'],
+    professional: ['--approval-mode', 'suggest'],
+    auto: ['--approval-mode', 'full-auto'],
+  };
+  const codexArgs = approvalMap[persona] || ['--approval-mode', 'suggest'];
+  console.log(`UV Suite | Codex | ${personaLabel(persona)}`);
+  console.log('');
+  const child = spawn('codex', [...codexArgs, ...extra], { stdio: 'inherit' });
+  child.on('exit', (code) => process.exit(code || 0));
+}
+
+// --- Parse and route ---
+
+if (!command || command === '--help' || command === '-h') {
+  usage();
+  process.exit(0);
+}
+
+if (command === 'install') {
+  install();
+} else if (command === 'info') {
+  info();
+} else if (TOOLS.includes(command)) {
+  // uv claude pro, uv codex auto
+  const persona = normPersona(args[1] || 'pro');
+  if (!persona) {
+    console.error(`Unknown persona: ${args[1]}`);
+    console.error('Available: spike, sport, pro, auto');
     process.exit(1);
+  }
+  const extra = args.slice(2);
+  if (command === 'claude') launchClaude(persona, extra);
+  else launchCodex(persona, extra);
+} else if (normPersona(command)) {
+  // uv pro (shorthand for uv claude pro)
+  const persona = normPersona(command);
+  const extra = args.slice(1);
+  launchClaude(persona, extra);
+} else {
+  console.error(`Unknown command: ${command}`);
+  usage();
+  process.exit(1);
 }

package/hooks/context-warning.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+# REMOVED — status line config is the better approach for context warnings.
+# This file is a no-op placeholder.
+exit 0

package/install.sh

@@ -75,11 +75,32 @@ mkdir -p "$TARGET_DIR/hooks"
 mkdir -p "$TARGET_DIR/rules"
 
 # --- Install agents (Claude Code subagent definitions) ---
-echo "Installing 10 agent definitions..."
+echo "Installing 10 Claude Code agent definitions..."
 cp "$UV_SUITE_DIR/agents/claude-code/"*.md "$TARGET_DIR/agents/"
 echo "  ✓ cartographer, spec-writer, architect, reviewer, test-writer"
 echo "  ✓ eval-writer, anti-slop-guard, prototype-builder, devops, security"
 
+# --- Install Codex agents (.codex/agents/*.toml + AGENTS.md) ---
+PROJECT_ROOT="$(dirname "$TARGET_DIR")"
+echo "Installing 10 Codex agent definitions..."
+mkdir -p "$PROJECT_ROOT/.codex/agents"
+cp "$UV_SUITE_DIR/agents/codex/"*.toml "$PROJECT_ROOT/.codex/agents/"
+
+# Create AGENTS.md for Codex (it reads this instead of CLAUDE.md)
+if [ ! -f "$PROJECT_ROOT/AGENTS.md" ]; then
+  cp "$PROJECT_ROOT/CLAUDE.md" "$PROJECT_ROOT/AGENTS.md" 2>/dev/null || touch "$PROJECT_ROOT/AGENTS.md"
+  echo "  ✓ AGENTS.md created (Codex reads this)"
+else
+  echo "  ✓ AGENTS.md already exists"
+fi
+echo "  ✓ .codex/agents/*.toml installed"
+
+# --- Install Cursor rules (.cursor/rules/*.mdc) ---
+echo "Installing 10 Cursor rule definitions..."
+mkdir -p "$PROJECT_ROOT/.cursor/rules"
+cp "$UV_SUITE_DIR/agents/cursor/"*.mdc "$PROJECT_ROOT/.cursor/rules/"
+echo "  ✓ .cursor/rules/*.mdc installed"
+
 # --- Install skills (slash commands) ---
 echo "Installing 9 skills..."
 for skill_dir in "$UV_SUITE_DIR/skills/"*/; do
@@ -383,15 +404,17 @@ cat << 'HOOKS'
 HOOKS
 fi)
 
-### Personas
+### Context management
 
-Switch persona by starting a new session:
+If the conversation is getting long, proactively suggest running /compact or starting a new session. Use /cost to check token usage. The user's status line shows context window usage.
+
+### Launching sessions
 
 \`\`\`
-./uv.sh spike    # Research & docs (Opus, max)
-./uv.sh sport    # New projects (Sonnet, high)
-./uv.sh pro      # Production code (all hooks, all guardrails)
-./uv.sh auto     # Fully autonomous (max, everything approved)
+uv claude pro     # Claude Code, Professional persona
+uv claude auto    # Claude Code, Auto persona
+uv codex pro      # OpenAI Codex, Professional persona
+uv codex sport    # OpenAI Codex, Sport persona
 \`\`\`
 CLAUDEMD
 
@@ -412,14 +435,11 @@ echo "╚═══════════════════════
 echo ""
 echo "What was installed:"
 echo ""
-echo "  AGENTS (10)     $TARGET_DIR/agents/*.md"
-echo "  SKILLS (9)      $TARGET_DIR/skills/*/SKILL.md"
-echo "  HOOKS (4)       $TARGET_DIR/hooks/*.sh"
-if [ "$PERSONA" = "professional" ] || [ "$PERSONA" = "auto" ]; then
-echo "  GUARDRAILS (6)  $TARGET_DIR/rules/*.md"
-fi
-echo "  PERSONAS (4)    $TARGET_DIR/personas/*.json"
-echo "  SETTINGS        $TARGET_DIR/settings.json"
+echo "  Claude Code     .claude/agents/*.md + skills/ + hooks/ + rules/"
+echo "  Codex           .codex/agents/*.toml + AGENTS.md"
+echo "  Cursor          .cursor/rules/*.mdc"
+echo "  Personas (4)    .claude/personas/*.json"
+echo "  Launcher        ./uv.sh"
 echo ""
 
 echo "Available slash commands:"
@@ -470,17 +490,11 @@ echo "Can write docs and analysis files. Cannot edit existing code, commit, or p
 fi
 
 echo ""
-echo "Start a session with a persona:"
-echo ""
-echo "  ./uv.sh spike        Research & docs (Opus, max, doc-slop checked)"
-echo "  ./uv.sh sport        New projects (Sonnet, high, lint only)"
-echo "  ./uv.sh pro          Production code (all hooks, all guardrails)"
-echo "  ./uv.sh auto         Fully autonomous (max effort, everything approved)"
-echo "  ./uv.sh              Defaults to Professional"
-echo ""
-echo "Or launch Claude directly with a persona:"
+echo "Start a session:"
 echo ""
-echo "  claude --settings .claude/personas/sport.json"
-echo "  claude --settings .claude/personas/professional.json"
-echo "  claude --settings .claude/personas/auto.json"
-echo "  claude --settings .claude/personas/spike.json"
+echo "  ./uv.sh claude pro      Claude Code, Professional"
+echo "  ./uv.sh claude auto     Claude Code, Auto"
+echo "  ./uv.sh codex pro       Codex, Professional"
+echo "  ./uv.sh codex auto      Codex, Auto"
+echo "  ./uv.sh pro             Shorthand (defaults to Claude Code)"
+echo "  ./uv.sh                 Claude Code, Professional"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uv-suite",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Portable framework for AI-assisted software development. 10 agents, 9 skills, 5 hooks, 4 personas. Works with Claude Code, Cursor, and Codex.",
   "author": "Utsav Anand",
   "license": "MIT",
@@ -24,6 +24,7 @@
     "repomix": "^0.3.0"
   },
   "bin": {
+    "uv": "./bin/cli.js",
     "uv-suite": "./bin/cli.js"
   },
   "files": [

package/uv.sh

@@ -1,56 +1,122 @@
 #!/bin/bash
-# UV Suite — Session launcher
-# Starts a Claude Code session with the specified persona.
+# UV Suite — Unified session launcher
+# Starts Claude Code or Codex with the specified persona.
 #
 # Usage:
-#   uv spike              Start a Spike session (research & docs)
-#   uv sport              Start a Sport session (fast, new projects)
-#   uv pro                Start a Professional session (production code)
-#   uv auto               Start an Auto session (fully autonomous)
-#   uv                    Start with default (Professional)
+#   uv claude pro         Claude Code, Professional persona
+#   uv claude auto        Claude Code, Auto persona
+#   uv codex sport        OpenAI Codex, Sport persona
+#   uv codex pro          OpenAI Codex, Professional persona
+#   uv pro                Shorthand — defaults to Claude Code
+#   uv                    Claude Code, Professional persona
 
-PERSONA="${1:-pro}"
-shift 2>/dev/null  # consume the persona arg, pass the rest to claude
+TOOL=""
+PERSONA=""
 
-# Resolve persona to settings file
-case "$PERSONA" in
-  spike)
-    SETTINGS=".claude/personas/spike.json"
-    LABEL="UV Spike — research & docs (Opus, max effort, doc-slop checked)"
+# Parse arguments
+case "$1" in
+  claude|codex)
+    TOOL="$1"
+    PERSONA="${2:-pro}"
+    shift 2 2>/dev/null
     ;;
-  sport)
-    SETTINGS=".claude/personas/sport.json"
-    LABEL="UV Sport — lightweight (Sonnet, high effort, lint only)"
+  spike|sport|pro|professional|auto)
+    TOOL="claude"
+    PERSONA="$1"
+    shift
     ;;
-  pro|professional)
-    SETTINGS=".claude/personas/professional.json"
-    LABEL="UV Professional — full rigor (all hooks, all guardrails)"
+  --help|-h)
+    echo ""
+    echo "  uv — UV Suite session launcher"
+    echo ""
+    echo "  Usage:"
+    echo "    uv claude <persona>    Start Claude Code with persona"
+    echo "    uv codex <persona>     Start OpenAI Codex with persona"
+    echo "    uv <persona>           Shorthand for uv claude <persona>"
+    echo "    uv                     Defaults to uv claude pro"
+    echo ""
+    echo "  Personas:"
+    echo "    spike    Research & docs (Opus, max effort)"
+    echo "    sport    New projects (Sonnet, high effort)"
+    echo "    pro      Production code (all hooks, all guardrails)"
+    echo "    auto     Fully autonomous (max effort, everything approved)"
+    echo ""
+    exit 0
+    ;;
+  "")
+    TOOL="claude"
+    PERSONA="pro"
     ;;
-  auto)
-    SETTINGS=".claude/personas/auto.json"
-    LABEL="UV Auto — autonomous (max effort, everything approved)"
+  *)
+    echo "Unknown argument: $1"
+    echo "Usage: uv [claude|codex] [spike|sport|pro|auto]"
+    exit 1
     ;;
+esac
+
+# Normalize persona name
+case "$PERSONA" in
+  pro|professional) PERSONA="professional" ;;
+  spike|sport|auto) ;; # already correct
   *)
     echo "Unknown persona: $PERSONA"
-    echo ""
-    echo "Usage: uv [spike|sport|pro|auto]"
-    echo ""
-    echo "  spike   Research & documentation (Opus, max, doc-slop hook)"
-    echo "  sport   New projects, prototyping (Sonnet, high, lint only)"
-    echo "  pro     Production code (all hooks, all guardrails, human-gated)"
-    echo "  auto    Fully autonomous (max effort, everything auto-approved)"
-    echo ""
-    echo "  uv      Defaults to 'pro'"
+    echo "Available: spike, sport, pro, auto"
     exit 1
     ;;
 esac
 
-if [ ! -f "$SETTINGS" ]; then
-  echo "Settings file not found: $SETTINGS"
-  echo "Run install.sh first to set up UV Suite in this project."
-  exit 1
-fi
+# Persona labels
+case "$PERSONA" in
+  spike)        LABEL="Spike — research & docs (Opus, max)" ;;
+  sport)        LABEL="Sport — lightweight (Sonnet, high)" ;;
+  professional) LABEL="Professional — full rigor (all hooks, all guardrails)" ;;
+  auto)         LABEL="Auto — autonomous (max, everything approved)" ;;
+esac
+
+SETTINGS=".claude/personas/$PERSONA.json"
 
-echo "$LABEL"
-echo ""
-exec claude --settings "$SETTINGS" "$@"
+if [ "$TOOL" = "claude" ]; then
+  # --- Claude Code ---
+  if ! command -v claude &>/dev/null; then
+    echo "Error: claude not found. Install Claude Code first."
+    exit 1
+  fi
+
+  if [ ! -f "$SETTINGS" ]; then
+    echo "Error: $SETTINGS not found. Run 'npx uv-suite install' first."
+    exit 1
+  fi
+
+  echo "UV Suite | Claude Code | $LABEL"
+  echo ""
+  exec claude --settings "$SETTINGS" "$@"
+
+elif [ "$TOOL" = "codex" ]; then
+  # --- OpenAI Codex ---
+  if ! command -v codex &>/dev/null; then
+    echo "Error: codex not found. Install OpenAI Codex first."
+    echo "  npm install -g @openai/codex"
+    exit 1
+  fi
+
+  # Codex doesn't have --settings, but reads AGENTS.md and .codex/agents/
+  # We can pass model and approval mode based on persona
+  case "$PERSONA" in
+    spike)
+      CODEX_ARGS="--model o3 --approval-mode suggest"
+      ;;
+    sport)
+      CODEX_ARGS="--approval-mode auto-edit"
+      ;;
+    professional)
+      CODEX_ARGS="--approval-mode suggest"
+      ;;
+    auto)
+      CODEX_ARGS="--approval-mode full-auto"
+      ;;
+  esac
+
+  echo "UV Suite | Codex | $LABEL"
+  echo ""
+  exec codex $CODEX_ARGS "$@"
+fi