aiwcli 0.15.1 → 0.15.3

package/dist/templates/_shared/skills/codex/scripts/watch-codex.ts

@@ -0,0 +1,42 @@
+#!/usr/bin/env bun
+/**
+ * Thin CLI wrapper over lib/codex-watcher.ts for backward compatibility.
+ *
+ * Usage:
+ *   bun watch-codex.ts <pane_id> <session_id> <session_file>
+ *
+ * Prefer using launch-codex.ts directly (watch is built-in by default).
+ */
+import {
+  SUMMARY_UNAVAILABLE_MESSAGE,
+  summarizeFromSessionFileFallback,
+  summarizeViaResume,
+  summarizeViaSessionFileSpark,
+  waitForPaneClose,
+} from "../lib/codex-watcher.js";
+
+async function main(): Promise<void> {
+  const [paneId, sessionId, sessionFile] = process.argv.slice(2);
+  if (!paneId) {
+    console.log(SUMMARY_UNAVAILABLE_MESSAGE);
+    return;
+  }
+
+  await waitForPaneClose(paneId);
+
+  const sf = sessionFile ?? "";
+  const sid = sessionId ?? "";
+  const summary =
+    summarizeViaSessionFileSpark(sf) ??
+    (sid ? await summarizeViaResume(sid) : null) ??
+    summarizeFromSessionFileFallback(sf) ??
+    SUMMARY_UNAVAILABLE_MESSAGE;
+
+  console.log("\n--- Codex Session Summary ---");
+  console.log(summary);
+}
+
+main().catch((error) => {
+  console.error(`watch-codex error: ${String(error)}`);
+  console.log(SUMMARY_UNAVAILABLE_MESSAGE);
+});

package/oclif.manifest.json

@@ -275,7 +275,7 @@
     "launch": {
       "aliases": [],
       "args": {},
-      "description": "Launch Claude Code or Codex with AIW configuration (sandbox disabled, tmux-first by default)\n\nFLAGS\n  --codex/-c: Launch Codex instead of Claude Code (uses --yolo flag)\n  --new/-n: Open a new terminal in the current directory and launch there\n  --no-tmux/-t: Launch directly in current shell instead of auto-launching tmux\n  --tmux-session/-s: tmux session name to reuse when auto-launching tmux (default is fresh session per launch)\n\nEXIT CODES\n  0  Success - AI assistant launched and exited successfully\n  1  General error - unexpected runtime failure\n  2  Invalid usage - check your arguments and flags\n  3  Environment error - CLI/tmux not found (install Claude Code from https://claude.ai/download, Codex from npm, tmux from your package manager)",
+      "description": "Launch Claude Code or Codex with AIW configuration (sandbox disabled, tmux-first by default)\n\nFLAGS\n  --codex/-c: Launch Codex instead of Claude Code (uses --yolo flag)\n  --new/-n: Open a new terminal in the current directory and launch there\n  --no-tmux/-t: Launch directly in current shell instead of auto-launching tmux\n  --tmux-session/-s: tmux session name to reuse when auto-launching tmux (default is fresh session per launch)\n\nEXIT CODES\n  0  Success - AI assistant launched and exited successfully\n  1  General error - unexpected runtime failure\n  2  Invalid usage - check your arguments and flags\n  3  Environment error - CLI not found (install Claude Code from https://claude.ai/download, Codex from npm)",
       "examples": [
         "<%= config.bin %> <%= command.id %>  # Auto-launches tmux with a fresh session when not already in tmux",
         "<%= config.bin %> <%= command.id %> --codex  # Launch Codex with --yolo flag",
@@ -434,5 +434,5 @@
       ]
     }
   },
-  "version": "0.15.1"
+  "version": "0.15.3"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "aiwcli",
   "description": "AI Workflow CLI - Command-line interface for AI-powered workflows",
-  "version": "0.15.1",
+  "version": "0.15.3",
   "author": "jofu-tofu",
   "bin": {
     "aiw": "bin/run.js"

package/dist/templates/_shared/.claude/skills/codex/prompt.md

@@ -1,30 +0,0 @@
-# /codex
-
-| Command | Description |
-|---|---|
-| `bun launch-codex.ts [--model fast|standard|smart|<model-id>] [--sandbox read-only|workspace-write|danger-full-access] [--no-yolo] [--capture] plan` | Launch Codex REPL with active plan. |
-| `bun launch-codex.ts [--model fast|standard|smart|<model-id>] [--sandbox read-only|workspace-write|danger-full-access] [--no-yolo] [--capture] --file <path>` | Launch Codex REPL with file contents. |
-| `bun launch-codex.ts [--model fast|standard|smart|<model-id>] [--sandbox read-only|workspace-write|danger-full-access] [--no-yolo] [--capture] <inline text...>` | Launch Codex REPL with inline prompt. |
-
-- `--model`: model tier (`fast`/`standard`/`smart`) resolves to `gpt-5.3-codex-spark` / `gpt-5.3-codex`, or any explicit Codex model id. Aliases: `spark`, `codex`, `gpt`.
-- `--sandbox`: `read-only`, `workspace-write`, or `danger-full-access`. Default is `danger-full-access` for implementation handoffs.
-- YOLO mode is **on by default** — bypasses all approvals and sandbox (`--dangerously-bypass-approvals-and-sandbox`). Use `--no-yolo` to disable.
-- `--capture`: best-effort session capture. If setup succeeds, launch output includes:
-  - `CODEX_CAPTURE_PANE=<pane_id>`
-  - `CODEX_CAPTURE_SESSION_ID=<session_id>`
-  - `CODEX_CAPTURE_SESSION_FILE=<path>`
-
-If launch output includes `CODEX_CAPTURE_PANE` and `CODEX_CAPTURE_SESSION_ID`:
-
-1. Parse pane/session metadata from stdout.
-2. Start a background watcher:
-```bash
-bun .aiwcli/_shared/skills/prompt-codex/scripts/watch-codex.ts <pane_id> <session_id> <session_file>
-```
-Use `Bash` with `run_in_background: true`.
-3. Tell the user: `Codex is running in the tmux pane. I'll receive a summary when you exit.`
-4. Continue with other work; the background task output will arrive as a notification.
-
-Watcher behavior:
-- Primary: summarize from `CODEX_CAPTURE_SESSION_FILE` with Spark.
-- Fallback: use `codex exec resume <session_id>` if transcript summarization fails.

package/dist/templates/_shared/skills/prompt-codex/CLAUDE.md

@@ -1,71 +0,0 @@
-# Prompt Codex Skill
-
-Launch Codex CLI in a tmux pane and inject a prompt into its REPL.
-
-## Directory Structure
-
-```
-prompt-codex/
-├── CLAUDE.md       ← This file
-└── scripts/
-    ├── launch-codex.ts  ← CLI entry point
-    └── watch-codex.ts   ← Capture watcher and summarizer
-```
-
-## Script: launch-codex.ts
-
-**Usage:**
-```bash
-bun .aiwcli/_shared/skills/prompt-codex/scripts/launch-codex.ts [--model <tier|id>] [--sandbox <sandbox-mode>] [--full-auto] plan
-bun .aiwcli/_shared/skills/prompt-codex/scripts/launch-codex.ts [--model <tier|id>] [--sandbox <sandbox-mode>] [--full-auto] --file <path>
-bun .aiwcli/_shared/skills/prompt-codex/scripts/launch-codex.ts [--model <tier|id>] [--sandbox <sandbox-mode>] [--full-auto] <inline text...>
-bun .aiwcli/_shared/skills/prompt-codex/scripts/launch-codex.ts [--model <tier|id>] [--sandbox <sandbox-mode>] [--full-auto] [--capture] <mode>
-```
-
-**Args:**
-- `plan` — discover active plan via context system, inject into Codex REPL
-- `--file <path>` — inject file contents into Codex REPL
-- `<text...>` — join remaining args as inline prompt, write to temp file, inject
-- `--model <alias|tier|id>` — Aliases: `spark` → `gpt-5.3-codex-spark`, `codex` → `gpt-5.3-codex`, `gpt` → `gpt-5.2`. Tiers: `fast`/`standard`/`smart` (resolved via `resolveModelForProvider()`). Or any full model ID. Aliases are checked first (local `CODEX_ALIASES` constant in `launch-codex.ts`), then tiers, then pass-through. Omitted = Codex default.
-- `--sandbox <mode>` — `read-only`, `workspace-write`, or `danger-full-access`. Default is `danger-full-access` for implementation handoffs.
-- `--no-yolo` — Disable YOLO mode (on by default). YOLO maps to Codex CLI's `--dangerously-bypass-approvals-and-sandbox`. Use `--no-yolo` to restore normal approval prompts.
-- `--capture` — Best-effort session capture. On success, prints:
-  - `CODEX_CAPTURE_PANE=<pane_id>`
-  - `CODEX_CAPTURE_SESSION_ID=<session_id>`
-  - `CODEX_CAPTURE_SESSION_FILE=<session_file>`
-  These are consumed by the skill prompt to run `watch-codex.ts` as a background task.
-
-**Plan discovery order:**
-1. `CLAUDE_SESSION_ID` env → `getContextBySessionId()` → `findLatestPlan(contextId)`
-2. Fallback: scan `_output/contexts/*/plans/*.md` by mtime (inline, no `_cc-native` import)
-
-**Dependencies (all from `_shared/lib-ts/`):**
-- `base/tmux-driver.ts` — `launchDriverInTmuxOrFallback()`, `getTmuxAvailability()`
-- `base/cli-args.ts` — `resolveCodexModel()`, `codexReplSpec()`, `buildCliInvocation()`, `isCodexSandbox()`
-- `base/logger.ts` — `logDebug()`, `logWarn()` (injection diagnostics)
-- `context/context-store.ts` — `getContextBySessionId()`
-- `context/context-formatter.ts` — `buildExternalAgentContext()` (orientation header for Codex)
-- `context/plan-manager.ts` — `findLatestPlan()`
-
-**Design decisions:**
-- Always creates a new tmux pane (no pane reuse/tracking)
-- No exec fallback — REPL mode requires tmux
-- `_shared` only — never imports from `_cc-native`
-- Temp file cleanup after injection confirmed
-
-## Script: watch-codex.ts
-
-**Usage:**
-```bash
-bun .aiwcli/_shared/skills/prompt-codex/scripts/watch-codex.ts <pane_id> <session_id> <session_file>
-```
-
-**Behavior:**
-- Polls tmux until `<pane_id>` closes
-- Primary: parses `<session_file>` transcript and summarizes via Spark (`inference()` + `CODEX_MODELS.spark`)
-- Fallback: runs `codex exec resume <session_id>` if transcript summarization fails
-- Final fallback: emits concise transcript lines directly from `<session_file>`
-
-**Resilience policy:**
-- Capture path is best-effort and never blocks Codex launch
-- Watcher exits cleanly on poll/summary/parse failures with fallback text