pi-agent-extensions 0.1.0 → 0.2.1

package/README.md

@@ -2,17 +2,48 @@
 
 A collection of extensions for the [pi coding agent](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent).
 
+## Acknowledgments
+
+This project includes extensions adapted from [mitsuhiko/agent-stuff](https://github.com/mitsuhiko/agent-stuff) (Apache 2.0 / MIT License).
+
+**Special thanks to Armin Ronacher ([@mitsuhiko](https://github.com/mitsuhiko))** for creating and open-sourcing these excellent production-ready extensions:
+- `notify.ts` - Desktop notifications via OSC 777
+- `context.ts` - Context breakdown dashboard  
+- `files.ts` - Unified file browser with git integration
+- `review.ts` - Code review system
+- `loop.ts` - Iterative execution loop
+
+Original repository: https://github.com/mitsuhiko/agent-stuff
+
 ## Extensions
 
 | Extension | Type | Description | Status |
 |-----------|------|-------------|--------|
-| **sessions** | Command | Quick session picker with `/sessions` command | ✅ Stable |
-| **ask_user** | Tool | LLM can ask structured questions with options | ⚙️ Beta (v0.1.0) |
-| **handoff** | Command | Transfer context to a new focused session with `/handoff` | ✅ Stable |
+| **sessions** | Command | Quick session picker with `/sessions` | ✅ Stable |
+| **ask_user** | Tool | LLM can ask structured questions | ⚙️ Beta |
+| **handoff** | Command | Goal-driven context transfer `/handoff` | ✅ Stable |
+| **whimsical** | UI | Context-aware loading messages & exit | ✅ Stable |
+| **files** | Tool | Unified file browser & git integration | ✅ Stable |
+| **notify** | Tool | Desktop notifications via OSC 777 | ✅ Stable |
+| **context** | UI | Context breakdown dashboard | ✅ Stable |
+| **review** | Tool | Interactive code review system | ✅ Stable |
+| **loop** | Tool | Iterative execution loop | ✅ Stable |
+| **todos** | Tool | File-based todo list management | ✅ Stable |
+| **control** | RPC | Inter-session communication & control | ⚙️ Beta |
+| **answer** | Tool | Structured Q&A for complex queries | ⚙️ Beta |
+| **cwd_history** | Tracker | Tracks directory changes in context | ✅ Stable |
 
 ## Install
 
-### From Source (Until Published)
+### From npm (Recommended)
+
+```bash
+pi install npm:pi-agent-extensions
+```
+
+All extensions will be available immediately after installation.
+
+### From Source (For Development)
 
 ```bash
 # Clone the repository
@@ -35,14 +66,6 @@ pi -e /path/to/pi-agent-extensions/extensions/sessions/index.ts \
    -e /path/to/pi-agent-extensions/extensions/handoff/index.ts
 ```
 
-### From npm (When Published)
-
-```bash
-pi install npm:pi-agent-extensions
-```
-
-Both extensions will be available immediately after installation.
-
 ## Verify Installation
 
 After installing, start pi and look for the startup message:
@@ -169,6 +192,57 @@ Transfer context to a new focused session. Unlike `/compact` which summarizes ev
 
 See [docs/extensions/handoff.md](docs/extensions/handoff.md) for full documentation.
 
+### Whimsical
+
+A personality engine for Pi that makes waiting fun.
+
+**Usage:**
+
+```bash
+/whimsy         # Check status
+/whimsy chaos   # Enable chaos mode (Bollywood + Geek + Tips)
+/exit           # Graceful whimsical exit
+```
+
+**Features:**
+- **Context-Aware:** Messages change based on time of day (Morning/Night) and wait duration.
+- **Personality Modes:**
+  - `chaos`: The full experience (50% Bollywood, 30% Tips, 20% Geek).
+  - `bollywood`: 100% Bollywood dialogues & Hinglish memes.
+  - `geek`: Sci-Fi & Dev humor ("Reticulating splines...").
+- **Smart Exit:** `/exit` and `/bye` commands that ensure a clean terminal shutdown with a funny goodbye message.
+
+See [extensions/whimsical/README.md](extensions/whimsical/README.md) for details.
+
+### Productivity Tools
+
+**Files (`/files`)**
+Unified file explorer with git integration. Adapted from `agent-stuff`.
+- `/files` - Open file browser
+- `Ctrl+Shift+F` - Open file picker
+
+**Todos (`/todos`)**
+File-based todo list management (stores in `.pi/todos/`).
+- `/todos` - List and manage todos
+- Tool: `todo` (create, update, claim, close tasks)
+
+**Notify**
+Allows the agent to send desktop notifications (via terminal OSC 777).
+- Tool: `notify`
+
+**Review**
+Interactive code review system. The agent can request a review, and you can approve/reject/comment on specific files.
+- Tool: `request_review`
+
+**Loop**
+Iterative execution loop for complex tasks.
+- Tool: `run_loop`
+
+**Control**
+RPC-based session control. Allows sessions to talk to each other (e.g., a "manager" session spawning and controlling "worker" sessions).
+- Flag: `--session-control`
+- Tool: `send_to_session`
+
 ## Development
 
 ```bash

package/docs/extensions/whimsical-proposal.md

@@ -0,0 +1,63 @@
+# Whimsical Extension Upgrade Proposal
+
+## Overview
+Transform the `whimsical` extension from a simple random message picker into a context-aware, configurable "personality engine" for the Pi coding agent. The goal is to make waiting times feel shorter and more delightful by providing varied, relevant, and sometimes helpful feedback.
+
+## Core Features
+
+### 1. Categorized Message Banks
+Instead of a single flat list, messages will be organized into distinct categories:
+
+*   **Gerunds (The "Claude" Style):** Single, delightful -ing verbs.
+    *   *Examples:* "Schlepping...", "Combobulating...", "Flibbertigibbeting...", "Splines reticulating..."
+*   **Sci-Fi / Technical:** Jargon-heavy, futuristic, or retro-tech phrases.
+    *   *Examples:* "Reversing the polarity...", "Engaging warp drive...", "Defragging the matrix...", "Consulting the oracle..."
+*   **Relatable / Dev Struggles:** Humorous takes on the developer experience.
+    *   *Examples:* "Exiting Vim...", "Centering a div...", "Blaming the intern...", "It works on my machine..."
+*   **Bollywood Masala (New!):** Iconic dialogues reimagined for coding.
+    *   *Examples:*
+        *   "Picture abhi baaki hai mere dost..." (The movie/loading isn't over yet)
+        *   "Kitne bugs the?" (How many bugs were there?)
+        *   "Mere Karan Arjun aayenge..." (My results will come...)
+        *   "Ek semicolon ki keemat tum kya jaano..." (You don't know the value of one semicolon...)
+        *   "Utha le re baba... mereko nahi, is bug ko!" (Pick it up oh god... not me, this bug!)
+        *   "Risk hai toh ishq hai..." (If there's risk/bugs, there's love/dev)
+*   **Helpful / Tips:** Occasional useful tips about Pi features.
+    *   *Examples:* "Try /help for commands...", "Use /modes to switch models...", "Did you know? /diff shows changes..."
+
+### 2. Context Awareness
+*   **Time-of-Day:**
+    *   *Morning (5 AM - 10 AM):* "Caffeinating...", "Waking up the pixels...", "Brewing logic..."
+    *   *Late Night (12 AM - 4 AM):* "Burning the midnight oil...", "Compiling dream logic...", "Is it tomorrow yet?"
+*   **Long Wait Logic:**
+    *   If a turn takes > 5 seconds, switch from a simple "Thinking..." to a more elaborate "story" or a "self-deprecating" message ("Still thinking, I promise...", "Downloading more RAM...").
+
+### 3. Configuration (Slash Command)
+A new `/whimsy` command to control behavior:
+
+*   `/whimsy mode <mode>`:
+    *   `chaos`: (Default) Random mix of all categories (Gerunds 40%, SciFi 20%, Bollywood 30%, Tips 10%).
+    *   `classic`: Only short Gerunds.
+    *   `bollywood`: Only Bollywood dialogues.
+    *   `geek`: Only Sci-Fi/Dev jokes.
+*   `/whimsy level <0-10>`:
+    *   `0`: Disable (Standard "Thinking..." only).
+    *   `5`: Balanced (Mix of standard and whimsical).
+    *   `10`: Maximum weirdness (Always show a whimsical message).
+
+## Implementation Plan
+
+1.  **Refactor `extensions/whimsical/index.ts`:**
+    *   Create a `MessageManager` class to handle categories and logic.
+    *   Implement `pickMessage()` with context awareness (time, duration).
+    *   Add `setTimeout` loop to update message dynamically during long turns.
+
+2.  **Add Configuration:**
+    *   Register `/whimsy` command using `pi.registerCommand`.
+    *   Persist settings to `workspaceState` or similar if available (or just runtime memory for v1).
+
+3.  **Expand Message Library:**
+    *   Curate the lists based on the research (Claude, Discord, Sims, etc.).
+
+## Example "Story" Mode (Future)
+*   "Planting seeds..." -> (2s later) -> "Watering..." -> (2s later) -> "Harvesting results!"