mitsupi 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to agent-stuff are documented here.
 
+## 1.1.1
+
+* Removed the deprecated `qna` extension.
+* Added `uv` extension and skill for uv integration.
+
 ## 1.1.0
 
 * Added project review guidelines and preserved review state across navigation.

package/README.md

@@ -16,7 +16,6 @@ All skill files are in the [`skills`](skills) folder:
 * [`/web-browser`](skills/web-browser) - Claude Skill for using Puppeteer in a Node environment to browse the web
 * [`/tmux`](skills/tmux) - Claude Skill for driving tmux directly with keystrokes and pane output scraping
 * [`/sentry`](skills/sentry) - Alternative way to access Sentry as a Claude Skill for reading issues
-* [`/improve-skill`](skills/improve-skill) - Claude Skill for analyzing coding agent sessions to improve or create new skills
 * [`/pi-share`](skills/pi-share) - Claude Skill for loading and parsing session transcripts from shittycodingagent.ai
 * [`/anachb`](skills/anachb) - Claude Skill for querying Austrian public transport (VOR AnachB) for departures, routes, and disruptions
 * [`/oebb-scotty`](skills/oebb-scotty) - Claude Skill for Austrian rail travel planning via ÖBB Scotty API
@@ -26,8 +25,7 @@ All skill files are in the [`skills`](skills) folder:
 
 Custom extensions for the PI Coding Agent can be found in the [`pi-extensions`](pi-extensions) folder:
 
-* [`qna.ts`](pi-extensions/qna.ts) - Extracts questions from the last assistant message into the editor for easy answering. Uses Claude Haiku for cost-efficient extraction when available.
-* [`answer.ts`](pi-extensions/answer.ts) - Alternative to `qna.ts` with a custom interactive TUI for answering questions one by one.
+* [`answer.ts`](pi-extensions/answer.ts) - Interactive TUI for answering questions one by one.
 * [`review.ts`](pi-extensions/review.ts) - Code review command inspired by Codex. Supports reviewing uncommitted changes, against a base branch (PR style), specific commits, or with custom instructions. Includes Ctrl+R shortcut.
 * [`loop.ts`](pi-extensions/loop.ts) - Runs a prompt loop for rapid iterative coding with optional auto-continue control.
 * [`files.ts`](pi-extensions/files.ts) - Unified file browser that merges git status (dirty first) with session references, plus reveal/open/edit and diff actions.

package/intercepted-commands/pip

@@ -0,0 +1,7 @@
+#!/bin/bash
+echo "Error: pip is disabled. Use uv instead:" >&2
+echo "" >&2
+echo "  To install a package for a script: uv run --with PACKAGE python script.py" >&2
+echo "  To add a dependency to the project: uv add PACKAGE" >&2
+echo "" >&2
+exit 1

package/intercepted-commands/pip3

@@ -0,0 +1,7 @@
+#!/bin/bash
+echo "Error: pip3 is disabled. Use uv instead:" >&2
+echo "" >&2
+echo "  To install a package for a script: uv run --with PACKAGE python script.py" >&2
+echo "  To add a dependency to the project: uv add PACKAGE" >&2
+echo "" >&2
+exit 1

package/intercepted-commands/poetry

@@ -0,0 +1,3 @@
+#!/bin/bash
+echo "Error: Use uv instead of poetry (uv init, uv add, uv sync, uv run)" >&2
+exit 1

package/intercepted-commands/python

@@ -0,0 +1,50 @@
+#!/bin/bash
+
+# Check for disallowed module invocations
+for arg in "$@"; do
+    case "$arg" in
+        -mpip|-m\ pip|pip)
+            echo "Error: 'python -m pip' is disabled. Use uv instead:" >&2
+            echo "" >&2
+            echo "  To install a package for a script: uv run --with PACKAGE python script.py" >&2
+            echo "  To add a dependency to the project: uv add PACKAGE" >&2
+            echo "" >&2
+            exit 1
+            ;;
+        -mvenv|-m\ venv|venv)
+            echo "Error: 'python -m venv' is disabled. Use uv instead:" >&2
+            echo "" >&2
+            echo "  To create a virtual environment: uv venv" >&2
+            echo "" >&2
+            exit 1
+            ;;
+    esac
+done
+
+# Check for -m flag followed by pip or venv
+prev=""
+for arg in "$@"; do
+    if [ "$prev" = "-m" ]; then
+        case "$arg" in
+            pip)
+                echo "Error: 'python -m pip' is disabled. Use uv instead:" >&2
+                echo "" >&2
+                echo "  To install a package for a script: uv run --with PACKAGE python script.py" >&2
+                echo "  To add a dependency to the project: uv add PACKAGE" >&2
+                echo "" >&2
+                exit 1
+                ;;
+            venv)
+                echo "Error: 'python -m venv' is disabled. Use uv instead:" >&2
+                echo "" >&2
+                echo "  To create a virtual environment: uv venv" >&2
+                echo "" >&2
+                exit 1
+                ;;
+        esac
+    fi
+    prev="$arg"
+done
+
+# Dispatch to uv run python
+exec uv run python "$@"

package/intercepted-commands/python3

@@ -0,0 +1,50 @@
+#!/bin/bash
+
+# Check for disallowed module invocations
+for arg in "$@"; do
+    case "$arg" in
+        -mpip|-m\ pip|pip)
+            echo "Error: 'python3 -m pip' is disabled. Use uv instead:" >&2
+            echo "" >&2
+            echo "  To install a package for a script: uv run --with PACKAGE python script.py" >&2
+            echo "  To add a dependency to the project: uv add PACKAGE" >&2
+            echo "" >&2
+            exit 1
+            ;;
+        -mvenv|-m\ venv|venv)
+            echo "Error: 'python3 -m venv' is disabled. Use uv instead:" >&2
+            echo "" >&2
+            echo "  To create a virtual environment: uv venv" >&2
+            echo "" >&2
+            exit 1
+            ;;
+    esac
+done
+
+# Check for -m flag followed by pip or venv
+prev=""
+for arg in "$@"; do
+    if [ "$prev" = "-m" ]; then
+        case "$arg" in
+            pip)
+                echo "Error: 'python3 -m pip' is disabled. Use uv instead:" >&2
+                echo "" >&2
+                echo "  To install a package for a script: uv run --with PACKAGE python script.py" >&2
+                echo "  To add a dependency to the project: uv add PACKAGE" >&2
+                echo "" >&2
+                exit 1
+                ;;
+            venv)
+                echo "Error: 'python3 -m venv' is disabled. Use uv instead:" >&2
+                echo "" >&2
+                echo "  To create a virtual environment: uv venv" >&2
+                echo "" >&2
+                exit 1
+                ;;
+        esac
+    fi
+    prev="$arg"
+done
+
+# Dispatch to uv run python
+exec uv run python "$@"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mitsupi",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Armin's pi coding agent commands, skills, extensions, and themes",
   "repository": {
     "type": "git",

package/pi-extensions/answer.ts

@@ -1,7 +1,7 @@
 /**
  * Q&A extraction hook - extracts questions from assistant responses
  *
- * Alternative to qna.ts with a custom interactive TUI for answering questions.
+ * Custom interactive TUI for answering questions.
  *
  * Demonstrates the "prompt generator" pattern with custom TUI:
  * 1. /answer command gets the last assistant message

package/pi-extensions/uv.ts

@@ -0,0 +1,42 @@
+/**
+ * UV Extension - Redirects Python tooling to uv equivalents
+ *
+ * This extension wraps the bash tool to prepend intercepted-commands to PATH,
+ * which contains shim scripts that intercept common Python tooling commands
+ * and redirect agents to use uv instead.
+ *
+ * Intercepted commands:
+ * - pip/pip3: Blocked with suggestions to use `uv add` or `uv run --with`
+ * - poetry: Blocked with uv equivalents (uv init, uv add, uv sync, uv run)
+ * - python/python3: Redirected to `uv run python`, with special handling to
+ *   block `python -m pip` and `python -m venv`
+ *
+ * The shim scripts are located in the intercepted-commands directory and
+ * provide helpful error messages with the equivalent uv commands.
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { createBashTool } from "@mariozechner/pi-coding-agent";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const interceptedCommandsPath = join(__dirname, "..", "intercepted-commands");
+
+export default function (pi: ExtensionAPI) {
+  const cwd = process.cwd();
+  const bashTool = createBashTool(cwd, {
+    commandPrefix: `export PATH="${interceptedCommandsPath}:$PATH"`,
+  });
+
+  pi.on("session_start", (_event, ctx) => {
+    ctx.ui.notify("UV interceptor loaded", "info");
+  });
+
+  pi.registerTool({
+    ...bashTool,
+    async execute(id, params, onUpdate, _ctx, signal) {
+      return bashTool.execute(id, params, signal, onUpdate);
+    },
+  });
+}

package/skills/uv/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: uv
+description: "Use `uv` instead of pip/python/venv. Run scripts with `uv run script.py`, add deps with `uv add`, use inline script metadata for standalone scripts."
+---
+
+## Quick Reference
+
+```bash
+uv run script.py                   # Run a script
+uv run --with requests script.py   # Run with ad-hoc dependency
+uv add requests                    # Add dependency to project
+uv init --script foo.py            # Create script with inline metadata
+```
+
+## Inline Script Dependencies
+
+```python
+# /// script
+# requires-python = ">=3.12"
+# dependencies = ["requests"]
+# ///
+```
+
+See [scripts.md](scripts.md) for full details on running scripts, locking, and reproducibility.
+
+## Build Backend
+
+Use `uv_build` for pure Python packages:
+
+```toml
+[build-system]
+requires = ["uv_build>=0.9.28,<0.10.0"]
+build-backend = "uv_build"
+```
+
+See [build.md](build.md) for project structure, namespaces, and file inclusion.

package/skills/uv/build.md

@@ -0,0 +1,65 @@
+# uv Build Backend
+
+Use `uv_build` for pure Python packages. For extension modules, use `hatchling` instead.
+
+## pyproject.toml
+
+```toml
+[project]
+name = "my-package"
+version = "0.1.0"
+requires-python = ">=3.12"
+dependencies = []
+
+[build-system]
+requires = ["uv_build>=0.9.28,<0.10.0"]
+build-backend = "uv_build"
+```
+
+## Project Structure
+
+Default layout uses `src/<package_name>/__init__.py`:
+
+```
+pyproject.toml
+src/
+└── my_package/
+    └── __init__.py
+```
+
+Package name is normalized: `Foo-Bar` → `foo_bar`.
+
+### Custom Module Location
+
+```toml
+[tool.uv.build-backend]
+module-name = "mymodule"
+module-root = ""  # Use project root instead of src/
+```
+
+### Namespace Packages
+
+For `foo.bar` namespace:
+
+```
+src/foo/bar/__init__.py  # No __init__.py in foo/
+```
+
+```toml
+[tool.uv.build-backend]
+module-name = "foo.bar"
+```
+
+## File Inclusion/Exclusion
+
+Excludes `__pycache__`, `*.pyc`, `*.pyo` by default.
+
+```toml
+[tool.uv.build-backend]
+source-include = ["assets/**"]
+source-exclude = ["/dist", "tests/**"]
+```
+
+- Includes are anchored (`pyproject.toml` = only root)
+- Excludes are not anchored (`__pycache__` = all dirs named that)
+- Use `/prefix` to anchor excludes

package/skills/uv/scripts.md

@@ -0,0 +1,98 @@
+# Running Scripts with uv
+
+## Basic Usage
+
+```bash
+uv run script.py                   # Run a script
+uv run script.py arg1 arg2         # With arguments
+uv run --python 3.10 script.py     # Specific Python version
+echo 'print("hi")' | uv run -      # From stdin
+```
+
+In a project directory, use `--no-project` to skip installing the project:
+
+```bash
+uv run --no-project script.py
+```
+
+## Ad-hoc Dependencies
+
+```bash
+uv run --with requests script.py
+uv run --with 'requests>2,<3' script.py
+uv run --with requests --with rich script.py
+```
+
+## Inline Script Metadata (Recommended)
+
+Declare dependencies directly in the script:
+
+```python
+# /// script
+# requires-python = ">=3.12"
+# dependencies = [
+#   "requests<3",
+#   "rich",
+# ]
+# ///
+
+import requests
+from rich import print
+```
+
+Then just: `uv run script.py`
+
+### Managing Dependencies
+
+```bash
+uv init --script example.py --python 3.12   # Create script with metadata
+uv add --script example.py requests rich    # Add dependencies
+```
+
+### Alternative Index
+
+```bash
+uv add --index "https://example.com/simple" --script example.py requests
+```
+
+Adds to metadata:
+
+```python
+# [[tool.uv.index]]
+# url = "https://example.com/simple"
+```
+
+## Locking Dependencies
+
+```bash
+uv lock --script example.py  # Creates example.py.lock
+```
+
+## Reproducibility
+
+Pin resolution date:
+
+```python
+# /// script
+# dependencies = ["requests"]
+# [tool.uv]
+# exclude-newer = "2023-10-16T00:00:00Z"
+# ///
+```
+
+## Executable Scripts (Shebang)
+
+```python
+#!/usr/bin/env -S uv run --script
+# /// script
+# dependencies = ["httpx"]
+# ///
+
+import httpx
+print(httpx.get("https://example.com"))
+```
+
+```bash
+chmod +x myscript
+./myscript
+```

package/pi-extensions/qna.ts

@@ -1,167 +0,0 @@
-/**
- * Q&A extraction hook - extracts questions from assistant responses
- *
- * Demonstrates the "prompt generator" pattern:
- * 1. /qna command gets the last assistant message
- * 2. Shows a spinner while extracting (hides editor)
- * 3. Loads the result into the editor for user to fill in answers
- */
-
-import { complete, type Model, type Api, type UserMessage } from "@mariozechner/pi-ai";
-import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
-import { BorderedLoader } from "@mariozechner/pi-coding-agent";
-
-const SYSTEM_PROMPT = `You are a question extractor. Given text from a conversation, extract any questions that need answering and format them for the user to fill in.
-
-Output format:
-- List each question on its own line, prefixed with "Q: "
-- After each question, add a blank line for the answer prefixed with "A: "
-- If no questions are found, output "No questions found in the last message."
-- When there is important context needed to answer a question, use quote characters (">") and add it into the question block as additional lines.
-
-Example output:
-Q: What is your preferred database?
-> we can only configure MySQL and PostgreSQL because of what is implemented.
-A: 
-
-Q: Should we use TypeScript or JavaScript?
-A: 
-
-Keep questions in the order they appeared. Be concise.`;
-
-const HAIKU_MODEL_ID = "claude-haiku-4-5";
-
-/**
- * Check if the current model is a Claude Opus or Sonnet model from Anthropic provider.
- * If so, try to use claude-haiku-4-5 instead for cost efficiency.
- */
-async function selectExtractionModel(
-	currentModel: Model<Api>,
-	modelRegistry: { find: (provider: string, modelId: string) => Model<Api> | undefined; getApiKey: (model: Model<Api>) => Promise<string | undefined> },
-): Promise<Model<Api>> {
-	// Only consider switching if the provider is anthropic and the model is opus or sonnet
-	if (currentModel.provider !== "anthropic") {
-		return currentModel;
-	}
-
-	const modelId = currentModel.id.toLowerCase();
-	const isOpusOrSonnet = modelId.includes("opus") || modelId.includes("sonnet");
-	if (!isOpusOrSonnet) {
-		return currentModel;
-	}
-
-	// Try to find and use claude-haiku-4-5
-	const haikuModel = modelRegistry.find("anthropic", HAIKU_MODEL_ID);
-	if (!haikuModel) {
-		return currentModel;
-	}
-
-	// Check if we have an API key for the haiku model
-	const apiKey = await modelRegistry.getApiKey(haikuModel);
-	if (!apiKey) {
-		return currentModel;
-	}
-
-	return haikuModel;
-}
-
-export default function (pi: ExtensionAPI) {
-	const qnaHandler = async (ctx: ExtensionContext) => {
-			if (!ctx.hasUI) {
-				ctx.ui.notify("qna requires interactive mode", "error");
-				return;
-			}
-
-			if (!ctx.model) {
-				ctx.ui.notify("No model selected", "error");
-				return;
-			}
-
-			// Find the last assistant message on the current branch
-			const branch = ctx.sessionManager.getBranch();
-			let lastAssistantText: string | undefined;
-
-			for (let i = branch.length - 1; i >= 0; i--) {
-				const entry = branch[i];
-				if (entry.type === "message") {
-					const msg = entry.message;
-					if ("role" in msg && msg.role === "assistant") {
-						if (msg.stopReason !== "stop") {
-							ctx.ui.notify(`Last assistant message incomplete (${msg.stopReason})`, "error");
-							return;
-						}
-						const textParts = msg.content
-							.filter((c): c is { type: "text"; text: string } => c.type === "text")
-							.map((c) => c.text);
-						if (textParts.length > 0) {
-							lastAssistantText = textParts.join("\n");
-							break;
-						}
-					}
-				}
-			}
-
-			if (!lastAssistantText) {
-				ctx.ui.notify("No assistant messages found", "error");
-				return;
-			}
-
-			// Select the best model for extraction (prefer haiku for cost efficiency)
-			const extractionModel = await selectExtractionModel(ctx.model, ctx.modelRegistry);
-
-			// Run extraction with loader UI
-			const result = await ctx.ui.custom<string | null>((tui, theme, _kb, done) => {
-				const loader = new BorderedLoader(tui, theme, `Extracting questions using ${extractionModel.id}...`);
-				loader.onAbort = () => done(null);
-
-				// Do the work
-				const doExtract = async () => {
-					const apiKey = await ctx.modelRegistry.getApiKey(extractionModel);
-					const userMessage: UserMessage = {
-						role: "user",
-						content: [{ type: "text", text: lastAssistantText! }],
-						timestamp: Date.now(),
-					};
-
-					const response = await complete(
-						extractionModel,
-						{ systemPrompt: SYSTEM_PROMPT, messages: [userMessage] },
-						{ apiKey, signal: loader.signal },
-					);
-
-					if (response.stopReason === "aborted") {
-						return null;
-					}
-
-					return response.content
-						.filter((c): c is { type: "text"; text: string } => c.type === "text")
-						.map((c) => c.text)
-						.join("\n");
-				};
-
-				doExtract()
-					.then(done)
-					.catch(() => done(null));
-
-				return loader;
-			});
-
-			if (result === null) {
-				ctx.ui.notify("Cancelled", "info");
-				return;
-			}
-
-			ctx.ui.setEditorText(result);
-			ctx.ui.notify("Questions loaded. Edit and submit when ready.", "info");
-	};
-
-	pi.registerCommand("qna", {
-		description: "Extract questions from last assistant message into editor",
-		handler: (_args, ctx) => qnaHandler(ctx),
-	});
-
-	pi.registerShortcut("ctrl+,", {
-		description: "Extract questions into editor",
-		handler: qnaHandler,
-	});
-}

package/skills/improve-skill/SKILL.md

@@ -1,155 +0,0 @@
----
-name: improve-skill
-description: "Analyze coding agent session transcripts to improve existing skills or create new ones. Use when asked to improve a skill based on a session, or extract a new skill from session history."
----
-
-# Improve Skill
-
-This skill helps analyze coding agent sessions to improve or create skills. It works with Claude Code, Pi, and Codex session files.
-
-## Quick Start
-
-Extract the current session and generate an improvement prompt:
-
-```bash
-# Auto-detect agent and extract current session
-./scripts/extract-session.js
-```
-
-## Session Extraction
-
-The `extract-session.js` script finds and parses session files from any of the three agents:
-
-```bash
-# Auto-detect (uses most recent session for current working directory)
-./scripts/extract-session.js
-
-# Specify agent type
-./scripts/extract-session.js --agent claude
-./scripts/extract-session.js --agent pi
-./scripts/extract-session.js --agent codex
-
-# Specify a different working directory
-./scripts/extract-session.js --cwd /path/to/project
-
-# Use a specific session file
-./scripts/extract-session.js /path/to/session.jsonl
-```
-
-**Session file locations:**
-- **Claude Code**: `~/.claude/projects/<encoded-cwd>/*.jsonl`
-- **Pi**: `~/.pi/agent/sessions/<encoded-cwd>/*.jsonl`
-- **Codex**: `~/.codex/sessions/YYYY/MM/DD/*.jsonl`
-
-## Workflow: Improve an Existing Skill
-
-When asked to improve a skill based on a session:
-
-1. **Extract the session transcript:**
-   ```bash
-   ./scripts/extract-session.js > /tmp/session-transcript.txt
-   ```
-
-2. **Find the existing skill** in one of these locations:
-   - `~/.codex/skills/<skill-name>/SKILL.md`
-   - `~/.claude/skills/<skill-name>/SKILL.md`
-   - `~/.pi/agent/skills/<skill-name>/SKILL.md`
-
-3. **Generate an improvement prompt** for a new session:
-
-```
-═══════════════════════════════════════════════════════════════════════════════
-COPY THE FOLLOWING PROMPT INTO A NEW AGENT SESSION:
-═══════════════════════════════════════════════════════════════════════════════
-
-I need to improve the "<skill-name>" skill based on a session where I used it.
-
-First, read the current skill at: <path-to-skill>
-
-Then analyze this session transcript to understand:
-- Where I struggled to use the skill correctly
-- What information was missing from the skill
-- What examples would have helped
-- What I had to figure out on my own
-
-<session_transcript>
-<paste transcript here>
-</session_transcript>
-
-Based on this analysis, improve the skill by:
-1. Adding missing instructions or clarifications
-2. Adding examples for common use cases discovered
-3. Fixing any incorrect guidance
-4. Making the skill more concise where possible
-
-Write the improved skill back to the same location.
-
-═══════════════════════════════════════════════════════════════════════════════
-```
-
-## Workflow: Create a New Skill
-
-When asked to create a new skill from a session:
-
-1. **Extract the session transcript:**
-   ```bash
-   ./scripts/extract-session.js > /tmp/session-transcript.txt
-   ```
-
-2. **Generate a creation prompt** for a new session:
-
-```
-═══════════════════════════════════════════════════════════════════════════════
-COPY THE FOLLOWING PROMPT INTO A NEW AGENT SESSION:
-═══════════════════════════════════════════════════════════════════════════════
-
-Analyze this session transcript to extract a reusable skill called "<skill-name>":
-
-<session_transcript>
-<paste transcript here>
-</session_transcript>
-
-Create a new skill that captures:
-1. The core capability or workflow demonstrated
-2. Key commands, APIs, or patterns used
-3. Common pitfalls and how to avoid them
-4. Example usage for typical scenarios
-
-Write the skill to: ~/.codex/skills/<skill-name>/SKILL.md
-
-Use this format:
----
-name: <skill-name>
-description: "<one-line description>"
----
-
-# <Skill Name> Skill
-
-<overview and quick reference>
-
-## <Section for each major capability>
-
-<instructions and examples>
-
-═══════════════════════════════════════════════════════════════════════════════
-```
-
-## Why a Separate Session?
-
-The improvement prompt is meant to be copied into a **fresh agent session** because:
-
-1. **Token efficiency** - The current session already has a lot of context; starting fresh means only the transcript and skill are loaded
-2. **Clean analysis** - The new session can focus purely on improvement without being influenced by the current task
-3. **Reproducibility** - The prompt is self-contained and can be shared or reused
-
-## Tips for Good Skill Improvements
-
-When analyzing a transcript, look for:
-
-- **Confusion patterns** - Where did the agent retry or change approach?
-- **Missing examples** - What specific commands or code patterns were discovered?
-- **Workarounds** - What did the agent have to figure out that wasn't documented?
-- **Errors** - What failed and how was it resolved?
-- **Successful patterns** - What worked well and should be highlighted?
-
-Keep skills concise - focus on the most important information and examples.

package/skills/improve-skill/scripts/extract-session.js

@@ -1,349 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Extract session transcript from Claude Code, Pi, or Codex session files.
- * 
- * Usage:
- *   ./extract-session.js [session-path]
- *   ./extract-session.js --agent claude|pi|codex [--cwd /path/to/dir]
- * 
- * If no arguments, auto-detects based on current working directory.
- */
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// Parse arguments
-const args = process.argv.slice(2);
-let sessionPath = null;
-let agent = null;
-let cwd = process.cwd();
-
-for (let i = 0; i < args.length; i++) {
-  if (args[i] === '--agent' && args[i + 1]) {
-    agent = args[++i];
-  } else if (args[i] === '--cwd' && args[i + 1]) {
-    cwd = args[++i];
-  } else if (!args[i].startsWith('-')) {
-    sessionPath = args[i];
-  }
-}
-
-/**
- * Encode CWD for session path lookup
- */
-function encodeCwd(cwd, style) {
-  if (style === 'pi') {
-    // Pi uses: --<cwd-without-leading-slash-with-slashes-as-dashes>--
-    // e.g., /Users/mitsuhiko/Development/myproject -> --Users-mitsuhiko-Development-myproject--
-    const safePath = `--${cwd.replace(/^[/\\]/, '').replace(/[/\\:]/g, '-')}--`;
-    return safePath;
-  }
-  // Claude Code: just replace / with -
-  return cwd.replace(/\//g, '-');
-}
-
-/**
- * Find the most recent session file in a directory
- */
-function findMostRecentSession(dir) {
-  if (!fs.existsSync(dir)) return null;
-  
-  const files = fs.readdirSync(dir)
-    .filter(f => f.endsWith('.jsonl'))
-    .map(f => ({
-      name: f,
-      path: path.join(dir, f),
-      mtime: fs.statSync(path.join(dir, f)).mtime
-    }))
-    .sort((a, b) => b.mtime - a.mtime);
-  
-  return files.length > 0 ? files[0].path : null;
-}
-
-/**
- * Find Codex session matching CWD
- */
-function findCodexSession(targetCwd) {
-  const baseDir = path.join(os.homedir(), '.codex', 'sessions');
-  if (!fs.existsSync(baseDir)) return null;
-  
-  // Find all session files, sorted by mtime
-  const allSessions = [];
-  
-  function walkDir(dir) {
-    if (!fs.existsSync(dir)) return;
-    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-      const fullPath = path.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        walkDir(fullPath);
-      } else if (entry.name.endsWith('.jsonl')) {
-        allSessions.push({
-          path: fullPath,
-          mtime: fs.statSync(fullPath).mtime
-        });
-      }
-    }
-  }
-  
-  walkDir(baseDir);
-  allSessions.sort((a, b) => b.mtime - a.mtime);
-  
-  // Find most recent matching CWD
-  for (const session of allSessions.slice(0, 50)) { // Check last 50
-    try {
-      const firstLine = fs.readFileSync(session.path, 'utf8').split('\n')[0];
-      const data = JSON.parse(firstLine);
-      if (data.payload?.cwd === targetCwd) {
-        return session.path;
-      }
-    } catch (e) {
-      // Skip invalid files
-    }
-  }
-  
-  return null;
-}
-
-/**
- * Auto-detect session based on CWD
- */
-function autoDetectSession(cwd) {
-  // Try Claude Code first
-  const claudePath = path.join(os.homedir(), '.claude', 'projects', encodeCwd(cwd, 'claude'));
-  let session = findMostRecentSession(claudePath);
-  if (session) return { agent: 'claude', path: session };
-  
-  // Try Pi
-  const piPath = path.join(os.homedir(), '.pi', 'agent', 'sessions', encodeCwd(cwd, 'pi'));
-  session = findMostRecentSession(piPath);
-  if (session) return { agent: 'pi', path: session };
-  
-  // Try Codex
-  session = findCodexSession(cwd);
-  if (session) return { agent: 'codex', path: session };
-  
-  return null;
-}
-
-/**
- * Parse Claude Code session format
- */
-function parseClaudeSession(content) {
-  const messages = [];
-  const lines = content.trim().split('\n');
-  
-  for (const line of lines) {
-    try {
-      const entry = JSON.parse(line);
-      if (entry.message?.role && entry.message?.content) {
-        const msg = entry.message;
-        messages.push({
-          role: msg.role,
-          content: extractContent(msg.content),
-          timestamp: entry.timestamp
-        });
-      }
-    } catch (e) {
-      // Skip invalid lines
-    }
-  }
-  
-  return messages;
-}
-
-/**
- * Parse Pi session format
- */
-function parsePiSession(content) {
-  const messages = [];
-  const lines = content.trim().split('\n');
-  
-  for (const line of lines) {
-    try {
-      const entry = JSON.parse(line);
-      if (entry.type === 'message' && entry.message?.role) {
-        messages.push({
-          role: entry.message.role,
-          content: extractContent(entry.message.content),
-          timestamp: entry.timestamp
-        });
-      }
-    } catch (e) {
-      // Skip invalid lines
-    }
-  }
-  
-  return messages;
-}
-
-/**
- * Parse Codex session format
- */
-function parseCodexSession(content) {
-  const messages = [];
-  const lines = content.trim().split('\n');
-  
-  for (const line of lines) {
-    try {
-      const entry = JSON.parse(line);
-      if (entry.type === 'response_item' && entry.payload?.role) {
-        const payload = entry.payload;
-        messages.push({
-          role: payload.role,
-          content: extractContent(payload.content),
-          timestamp: entry.timestamp
-        });
-      }
-    } catch (e) {
-      // Skip invalid lines
-    }
-  }
-  
-  return messages;
-}
-
-/**
- * Extract text content from various content formats
- */
-function extractContent(content) {
-  if (typeof content === 'string') return content;
-  if (!Array.isArray(content)) return JSON.stringify(content);
-  
-  const parts = [];
-  for (const item of content) {
-    if (typeof item === 'string') {
-      parts.push(item);
-    } else if (item.type === 'text') {
-      parts.push(item.text);
-    } else if (item.type === 'input_text') {
-      parts.push(item.text);
-    } else if (item.type === 'tool_use') {
-      parts.push(`[Tool: ${item.name}]\n${JSON.stringify(item.input, null, 2)}`);
-    } else if (item.type === 'tool_result') {
-      const result = typeof item.content === 'string' 
-        ? item.content 
-        : JSON.stringify(item.content);
-      // Truncate long tool results
-      const truncated = result.length > 500 
-        ? result.slice(0, 500) + '\n[... truncated ...]'
-        : result;
-      parts.push(`[Tool Result]\n${truncated}`);
-    } else {
-      parts.push(`[${item.type}]`);
-    }
-  }
-  
-  return parts.join('\n');
-}
-
-/**
- * Format messages as readable transcript
- */
-function formatTranscript(messages, maxMessages = 100) {
-  const recent = messages.slice(-maxMessages);
-  const lines = [];
-  
-  for (const msg of recent) {
-    const role = msg.role.toUpperCase();
-    lines.push(`\n### ${role}:\n`);
-    lines.push(msg.content);
-  }
-  
-  if (messages.length > maxMessages) {
-    lines.unshift(`\n[... ${messages.length - maxMessages} earlier messages omitted ...]\n`);
-  }
-  
-  return lines.join('\n');
-}
-
-// Main
-async function main() {
-  let result;
-  
-  if (sessionPath) {
-    // Explicit path provided
-    if (!fs.existsSync(sessionPath)) {
-      console.error(`Session file not found: ${sessionPath}`);
-      process.exit(1);
-    }
-    // Guess agent from path
-    if (sessionPath.includes('.claude')) {
-      result = { agent: 'claude', path: sessionPath };
-    } else if (sessionPath.includes('.pi')) {
-      result = { agent: 'pi', path: sessionPath };
-    } else if (sessionPath.includes('.codex')) {
-      result = { agent: 'codex', path: sessionPath };
-    } else {
-      // Default to Claude format
-      result = { agent: 'claude', path: sessionPath };
-    }
-  } else if (agent) {
-    // Agent specified, find session for that agent
-    if (agent === 'claude') {
-      const dir = path.join(os.homedir(), '.claude', 'projects', encodeCwd(cwd, 'claude'));
-      const session = findMostRecentSession(dir);
-      if (!session) {
-        console.error(`No Claude Code session found for: ${cwd}`);
-        process.exit(1);
-      }
-      result = { agent: 'claude', path: session };
-    } else if (agent === 'pi') {
-      const dir = path.join(os.homedir(), '.pi', 'agent', 'sessions', encodeCwd(cwd, 'pi'));
-      const session = findMostRecentSession(dir);
-      if (!session) {
-        console.error(`No Pi session found for: ${cwd}`);
-        process.exit(1);
-      }
-      result = { agent: 'pi', path: session };
-    } else if (agent === 'codex') {
-      const session = findCodexSession(cwd);
-      if (!session) {
-        console.error(`No Codex session found for: ${cwd}`);
-        process.exit(1);
-      }
-      result = { agent: 'codex', path: session };
-    } else {
-      console.error(`Unknown agent: ${agent}`);
-      process.exit(1);
-    }
-  } else {
-    // Auto-detect
-    result = autoDetectSession(cwd);
-    if (!result) {
-      console.error(`No session found for: ${cwd}`);
-      console.error('Try specifying --agent claude|pi|codex or provide a session path directly.');
-      process.exit(1);
-    }
-  }
-  
-  // Read and parse session
-  const content = fs.readFileSync(result.path, 'utf8');
-  
-  let messages;
-  switch (result.agent) {
-    case 'claude':
-      messages = parseClaudeSession(content);
-      break;
-    case 'pi':
-      messages = parsePiSession(content);
-      break;
-    case 'codex':
-      messages = parseCodexSession(content);
-      break;
-  }
-  
-  // Output metadata and transcript
-  console.log(`# Session Transcript`);
-  console.log(`Agent: ${result.agent}`);
-  console.log(`File: ${result.path}`);
-  console.log(`Messages: ${messages.length}`);
-  console.log('');
-  console.log(formatTranscript(messages));
-}
-
-main().catch(e => {
-  console.error(e.message);
-  process.exit(1);
-});