mitsupi 1.1.0 → 1.4.0

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 All notable changes to agent-stuff are documented here.
 
+## Unreleased
+
+## 1.4.0
+
+* Added a prompt editor extension for managing prompt modes (create, rename, delete, and edit), with persistence and detection fixes.
+* Added a loop-fixing mode to `/review` with improved blocking-aware detection, plus branch/commit filtering and related review flow improvements. (#10)
+* Added new skills for native web search, cached repository checkout (`librarian`), Google Workspace, and Apple Mail.
+* Added a CLI interface for session control and gated control tool registration behind `--session-control`.
+* Added the `go-to-bed` late-night safety guard and improved auto-disable behavior.
+* Improved `/files` labels by appending git status information.
+* Improved `uv` command handling by blocking `py_compile` and suggesting AST-based syntax checks.
+
+## 1.3.0
+
+* Added `/session-breakdown` command with interactive TUI showing sessions, messages, tokens, and cost over the last 7/30/90 days with a GitHub-style contribution calendar.
+* Added messages/tokens tracking and large-count abbreviations to `/session-breakdown`.
+* Added progress reporting while analyzing sessions in `/session-breakdown`.
+* Added `/context` command for viewing context overview.
+* Added folder snapshot review mode to `/review`.
+* Improved review rubric with lessons from codex.
+* Added a `summarize` skill for converting files/URLs to Markdown via `markitdown`.
+
+## 1.2.0
+
+* Updated pi-extensions to use the new `ToolDefinition.execute` parameter order.
+* Fixed notify extension notifications to render plain Markdown.
+
+## 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

@@ -1,51 +1,69 @@
 # Agent Stuff
 
-This repository contains skills and extensions that I use in some form with projects.  Note that I usually fine-tune these for projects so they might not work without modification for you.
+This repository contains skills and extensions that I use across projects. Note that I often fine-tune these for specific repos, so some items may need small adjustments before reuse.
 
 It is released on npm as `mitsupi` for use with the [Pi](https://buildwithpi.ai/) package loader.
 
 ## Skills
 
-All skill files are in the [`skills`](skills) folder:
+All skills live in the [`skills`](skills) folder:
 
-* [`/commit`](skills/commit) - Claude Skill for creating git commits using concise Conventional Commits-style subjects
-* [`/update-changelog`](skills/update-changelog) - Claude Skill for updating changelogs with notable user-facing changes
-* [`/ghidra`](skills/ghidra) - Claude Skill for reverse engineering binaries using Ghidra's headless analyzer
-* [`/github`](skills/github) - Claude Skill for interacting with GitHub via the `gh` CLI (issues, PRs, runs, and APIs)
-* [`/openscad`](skills/openscad) - Claude Skill for creating and rendering OpenSCAD 3D models and exporting STL files
-* [`/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
-* [`/frontend-design`](skills/frontend-design) - Claude Skill for designing and implementing distinctive frontend interfaces
+* [`/anachb`](skills/anachb) - Query Austrian public transport (VOR AnachB) for departures, routes, and disruptions.
+* [`/apple-mail`](skills/apple-mail) - Search/read Apple Mail local storage and extract attachments.
+* [`/commit`](skills/commit) - Create git commits using concise Conventional Commits-style subjects.
+* [`/frontend-design`](skills/frontend-design) - Design and implement distinctive frontend interfaces.
+* [`/ghidra`](skills/ghidra) - Reverse engineer binaries using Ghidra's headless analyzer.
+* [`/github`](skills/github) - Interact with GitHub using the `gh` CLI (issues, PRs, runs, APIs).
+* [`/google-workspace`](skills/google-workspace) - Access Google Workspace APIs via local helper scripts.
+* [`/librarian`](skills/librarian) - Cache and refresh remote git repositories in `~/.cache/checkouts`.
+* [`/mermaid`](skills/mermaid) - Create and validate Mermaid diagrams with Mermaid CLI tooling.
+* [`/native-web-search`](skills/native-web-search) - Trigger native web search with concise summaries and source URLs.
+* [`/oebb-scotty`](skills/oebb-scotty) - Plan Austrian rail journeys via ÖBB Scotty API.
+* [`/openscad`](skills/openscad) - Create/render OpenSCAD models and export STL files.
+* [`/pi-share`](skills/pi-share) - Load and parse session transcripts from shittycodingagent.ai/buildwithpi URLs.
+* [`/sentry`](skills/sentry) - Fetch and analyze Sentry issues, events, transactions, and logs.
+* [`/summarize`](skills/summarize) - Convert files/URLs to Markdown via `uvx markitdown` and summarize.
+* [`/tmux`](skills/tmux) - Drive tmux sessions via keystrokes and pane output scraping.
+* [`/update-changelog`](skills/update-changelog) - Update changelogs with notable user-facing changes.
+* [`/uv`](skills/uv) - Use `uv` for Python dependency management and script execution.
+* [`/web-browser`](skills/web-browser) - Browser automation via Chrome/Chromium CDP.
 
-## PI Coding Agent Extensions
+## Pi Coding Agent Extensions
 
-Custom extensions for the PI Coding Agent can be found in the [`pi-extensions`](pi-extensions) folder:
+Custom extensions for Pi Coding Agent are in [`pi-extensions`](pi-extensions):
 
-* [`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.
-* [`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.
-* [`cwd-history.ts`](pi-extensions/cwd-history.ts) - Displays and manages recent working directory history inside the PI Coding Agent.
-* [`codex-tuning.ts`](pi-extensions/codex-tuning.ts) - Codex tuning helper for collecting samples and tagging outcomes during agent sessions.
-* [`todos.ts`](pi-extensions/todos.ts) - Todo manager extension with file-backed storage and a TUI for listing and editing todos.
-* [`whimsical.ts`](pi-extensions/whimsical.ts) - Replaces the default "Thinking..." message with random whimsical phrases like "Reticulating splines...", "Consulting the void...", or "Bribing the compiler...".
+* [`answer.ts`](pi-extensions/answer.ts) - Interactive TUI for answering questions one by one.
+* [`context.ts`](pi-extensions/context.ts) - Context breakdown (extensions, skills, AGENTS.md/CLAUDE.md) + token usage, including loaded-skill highlighting.
+* [`control.ts`](pi-extensions/control.ts) - Session control helpers (list controllable sessions, etc.).
+* [`files.ts`](pi-extensions/files.ts) - Unified file browser with git status + session references and reveal/open/edit/diff actions.
+* [`go-to-bed.ts`](pi-extensions/go-to-bed.ts) - Late-night safety guard with explicit confirmation after midnight.
+* [`loop.ts`](pi-extensions/loop.ts) - Prompt loop for rapid iterative coding with optional auto-continue.
+* [`notify.ts`](pi-extensions/notify.ts) - Native desktop notifications when the agent finishes.
+* [`prompt-editor.ts`](pi-extensions/prompt-editor.ts) - In-editor prompt mode selector with persistence, history, config, and shortcuts.
+* [`review.ts`](pi-extensions/review.ts) - Code review command (working tree, PR-style diff, commits, custom instructions, optional fix loop).
+* [`session-breakdown.ts`](pi-extensions/session-breakdown.ts) - TUI for 7/30/90-day session and cost analysis with usage graph.
+* [`todos.ts`](pi-extensions/todos.ts) - Todo manager extension with file-backed storage and TUI.
+* [`uv.ts`](pi-extensions/uv.ts) - Helpers for uv-based Python workflows.
+* [`whimsical.ts`](pi-extensions/whimsical.ts) - Replaces the default thinking message with random whimsical phrases.
 
-## PI Coding Agent Themes
+## Pi Coding Agent Themes
 
-This repository includes custom themes for the PI Coding Agent. The themes can be found in the [`pi-themes`](pi-themes) folder and customize the appearance and behavior of the agent interface.
+Custom themes are in [`pi-themes`](pi-themes):
+
+* [`nightowl.json`](pi-themes/nightowl.json) - Night Owl-inspired theme.
 
 ## Plumbing Commands
 
 These command files need customization before use. They live in [`plumbing-commands`](plumbing-commands):
 
-* [`/make-release`](plumbing-commands/make-release.md) - Automates repository release with version management
+* [`/make-release`](plumbing-commands/make-release.md) - Automates repository release with version management.
+
+## Intercepted Commands
 
-### Release Management
+Command wrappers live in [`intercepted-commands`](intercepted-commands):
 
-The plumbing release commands do not work without tuning!  But you can put claude to them and derive actually working ones.  I for instance use them in [absurd](h>
+* [`pip`](intercepted-commands/pip)
+* [`pip3`](intercepted-commands/pip3)
+* [`poetry`](intercepted-commands/poetry)
+* [`python`](intercepted-commands/python)
+* [`python3`](intercepted-commands/python3)

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,64 @@
+#!/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
+            ;;
+        -mpy_compile|-m\ py_compile|py_compile)
+            echo "Error: 'python -m py_compile' is disabled because it writes .pyc files to __pycache__." >&2
+            echo "" >&2
+            echo "  To verify syntax without bytecode output: uv run python -m ast path/to/file.py >/dev/null" >&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
+                ;;
+            py_compile)
+                echo "Error: 'python -m py_compile' is disabled because it writes .pyc files to __pycache__." >&2
+                echo "" >&2
+                echo "  To verify syntax without bytecode output: uv run python -m ast path/to/file.py >/dev/null" >&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,64 @@
+#!/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
+            ;;
+        -mpy_compile|-m\ py_compile|py_compile)
+            echo "Error: 'python3 -m py_compile' is disabled because it writes .pyc files to __pycache__." >&2
+            echo "" >&2
+            echo "  To verify syntax without bytecode output: uv run python -m ast path/to/file.py >/dev/null" >&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
+                ;;
+            py_compile)
+                echo "Error: 'python3 -m py_compile' is disabled because it writes .pyc files to __pycache__." >&2
+                echo "" >&2
+                echo "  To verify syntax without bytecode output: uv run python -m ast path/to/file.py >/dev/null" >&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.4.0",
   "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