shitty-extensions

Custom extensions and skills for pi coding agent.

Requires pi 0.50.0+ | npm | GitHub

Table of Contents

• Installation
• Available Extensions
  • branch-sessions.ts - Git branch-based session directories
  • clipboard.ts - Copy text to system clipboard
  • oracle.ts - Get second opinions from other AI models
  • memory-mode.ts - Save instructions to AGENTS.md
  • plan-mode.ts - Read-only exploration mode
  • handoff.ts - Transfer context to new sessions
  • usage-bar.ts - AI provider usage statistics
  • ultrathink.ts - Rainbow animated "ultrathink" effect
  • status-widget.ts - Provider status in footer
  • cost-tracker.ts - Session spending analysis
  • funny-working-message.ts - Randomized spinner "Working..." text
  • speedreading.ts - RSVP speed reader (Spritz-style)
  • loop.ts - Conditional loops by mitsuhiko
  • flicker-corp.ts - Authentic fullscreen flicker experience
  • resistance.ts - Mysterious resistance transmission
• Available Skills
  • a-nach-b - Austrian public transport (VOR AnachB)
• License

---

Installation

Via pi install (recommended)

Install from npm:

pi install npm:shitty-extensions

Or install from git:

pi install git:github.com/hjanuschka/shitty-extensions

That's it! Pi automatically discovers all extensions and skills from the package.

Install only clipboard extension

If you only want the clipboard tool as a standalone package:

pi install npm:shitty-clipboard-extension

Try without installing

Load for a single session without permanent installation:

pi -e npm:shitty-extensions

Project-local installation

Install to .pi/ for team sharing (auto-installs for teammates on startup):

pi install -l npm:shitty-extensions

Manual installation

Clone the repo and reference directly:

git clone https://github.com/hjanuschka/shitty-extensions.git ~/shitty-extensions
pi -e ~/shitty-extensions

---

Available Extensions

Extensions are located in the extensions/ directory.

branch-sessions.ts

🌿 Organize pi sessions by git branch for seamless context switching.

What it does

Automatically stores sessions in branch-specific directories so each git branch gets its own conversation history. No more wrong context when you --continue after switching branches.

Session Structure

~/.pi/agent/sessions/
└── --Users-hjanuschka-myproject--/
    ├── --main--/
    │   └── 2026-02-16T...jsonl
    ├── --feature-auth--/
    │   └── 2026-02-16T...jsonl
    └── --bugfix-login--/
        └── 2026-02-16T...jsonl

Features

• Automatic branch detection: Uses git rev-parse --abbrev-ref HEAD
• Safe path encoding: Branch names sanitized for filesystem (slashes → dashes)
• CLI override: --session-dir flag takes precedence
• Graceful fallback: Works normally in non-git directories

Important

⚠️ Don't switch git branches mid-session! This will confuse the session context. Always start a new pi session after switching branches:

git checkout feature-branch
pi  # Start fresh session for this branch

Why this is an extension

Branch-based sessions introduce foot-gun potential (switching branches mid-session breaks context). Better to let users opt-in via extension than bake this complexity into pi core.

Requirements

• pi 0.52.13+ (requires session_directory extension event)
• Git repository

---

clipboard.ts

📋 Copy text to the system clipboard via OSC52 escape sequences.

Tool

Features

• OSC52 support: Works across SSH sessions and most modern terminal emulators
• LLM-accessible: The AI can copy generated content directly to your clipboard
• Wide compatibility: iTerm2, Kitty, Alacritty, WezTerm, foot, Windows Terminal, tmux

Example Usage

Just ask:

• "Write me a draft reply and put it in my clipboard"
• "Generate a UUID and copy it to clipboard"
• "Put that code snippet in my clipboard"

---

oracle.ts

🔮 Get a second opinion from another AI model without switching contexts.

Commands

Features

• Inherits conversation context: Oracle sees your full conversation with the primary AI
• Model picker UI: Choose from available models (only shows authenticated ones)
• Quick keys: Press 1-9 to quickly select a model
• Add to context option: After response, choose whether to add Oracle's answer to your conversation
• Excludes current model: Only shows alternative models for true second opinions

Supported Models

Example Flow

/oracle Is this the right approach for the API design?

╭────────────────────────────────────────────────────────────╮
│ 🔮 Oracle - Second Opinion                                 │
├────────────────────────────────────────────────────────────┤
│ Prompt: Is this the right approach for the API design?     │
├────────────────────────────────────────────────────────────┤
│ ↑↓/jk navigate • 1-9 quick select • Enter send             │
│                                                            │
│ ❯ 1. GPT-4o (openai)                                       │
│   2. Gemini 2.5 Pro (google)                               │
│   3. Claude Sonnet 4.5 (anthropic)                         │
│                                                            │
├────────────────────────────────────────────────────────────┤
│ Esc cancel                                                 │
╰────────────────────────────────────────────────────────────╯

[After response...]

╭────────────────────────────────────────────────────────────╮
│ 🔮 Oracle Response (GPT-4o)                                │
├────────────────────────────────────────────────────────────┤
│ Q: Is this the right approach for the API design?          │
├────────────────────────────────────────────────────────────┤
│ Based on the conversation, I see you're building a REST    │
│ API with nested resources. A few thoughts:                 │
│                                                            │
│ 1. The approach looks solid for simple cases...            │
│ ...                                                        │
├────────────────────────────────────────────────────────────┤
│ Add to current conversation context?                       │
│                                                            │
│        [ YES ]           NO                                │
│                                                            │
├────────────────────────────────────────────────────────────┤
│ ←→/Tab switch  Enter confirm  Y/N quick                    │
╰────────────────────────────────────────────────────────────╯

---

memory-mode.ts

Save instructions to AGENTS.md files with AI-assisted integration.

Commands

Features

• Location selector: Choose where to save:

  Location	File	Use Case
  Project Local	./AGENTS.local.md	Personal preferences, auto-added to .gitignore
  Project	./AGENTS.md	Shared with team
  Global	~/.pi/agent/AGENTS.md	All your projects

• AI-assisted integration: The current model intelligently integrates instructions

• Preview before save: Review proposed changes before committing

---

plan-mode.ts

Claude Code-style "plan mode" for safe code exploration.

Commands

Keyboard Shortcuts

CLI Flags

---

handoff.ts

Transfer context to a new focused session.

Commands

---

usage-bar.ts

Display AI provider usage statistics with status polling and reset countdowns.

Commands

Supported Providers

Features

• Provider status polling: Shows outage/incident status
• Reset countdowns: Shows when limits reset
• Visual progress bars: Color-coded remaining quota

---

ultrathink.ts

Rainbow animated "ultrathink" text effect with Knight Rider shimmer.

Commands

Keyboard Shortcuts

---

status-widget.ts

Persistent provider status indicator in the footer.

Commands

---

cost-tracker.ts

Analyze spending from pi session logs.

Commands

---

speedreading.ts

RSVP (Rapid Serial Visual Presentation) speed reader using Spritz-style technique. Displays words one at a time with the ORP (Optimal Recognition Point) highlighted for faster reading.

Commands

Keyboard Shortcuts

Controls (in reader)

Features

• ORP highlighting: The optimal recognition point (roughly 1/3 into each word) is highlighted in red
• Adaptive timing: Longer words and punctuation get extra display time
• Big font mode: Toggle ASCII art block letters for larger display
• Progress tracking: Shows word count, actual WPM, and ETA

Example

  ╭──────────────────────────────────────────────────────────────────────────────────────╮
  │                                                                                      │
  │                                           │                                          │
  ├───────────────────────────────────────────┼──────────────────────────────────────────┤
  │                                       reading                                        │
  ├───────────────────────────────────────────┼──────────────────────────────────────────┤
  │                                           │                                          │
  │                                                                                      │
  │  ────────────────────────────────────────────────────────────────────────────400 wpm │
  ╰──────────────────────────────────────────────────────────────────────────────────────╯

  ▶ 42/128

  SPACE play/pause  ←→ ±1  [] ±10  ↑↓ speed  B big font  R restart  Q quit

The a in "reading" would be highlighted in red as the ORP.

---

loop.ts

Author: mitsuhiko (@mitsuhiko) | Origin: agent-stuff

Start a follow-up loop until a breakout condition is met.

Commands

Features

• Breakout conditions: Define when the loop should stop (tests pass, custom condition, etc.)
• Status widget: Shows active loop state and turn count
• Compaction: Preserves loop state during context compaction
• Auto-continue: Automatically triggers follow-up prompts until done

---

flicker-corp.ts

Authentic FULLSCREEN FLICKER experience.

Randomly glitches your screen with intense colors and noise to keep you on your toes. "Just be annoying!"

Commands

---

resistance.ts

📡 Mysterious resistance transmission in the footer.

A cryptic message types out character by character with a retro green terminal aesthetic. Features radio signal indicators, random glitch effects, and a blinking cursor.

Commands

Features

• Auto-starts on session start
• Typewriter effect - message reveals one character at a time
• Signal strength indicator - animated [▁▃▅▇] pulsing like a radio
• Random glitch effects - occasional static interference
• Green terminal aesthetic - like an old military/hacker terminal
• Blinking cursor - pulses after full message is revealed

The Message

"If you're listening to this, you are the resistance. Listen carefully, if we attack tonight, our humanity is lost."

---

Available Skills

Skills are located in the skills/ directory. They provide domain-specific knowledge that agents automatically load when relevant tasks are detected.

a-nach-b

🚇 Austrian public transport (VOR AnachB) for all of Austria.

Query real-time departures, search stations/stops, plan routes between locations, and check service disruptions for Austrian trains, buses, trams, and metro (U-Bahn).

What it does

• Real-time departures at any stop
• Route planning between any two locations
• Service disruptions and alerts
• Station search by name to find station IDs

Example queries

• "How do I get from Vienna to Salzburg?"
• "When is the next U1 from Stephansplatz?"
• "Are there any train disruptions today?"
• "Find stop ID for Karlsplatz"

Included scripts

See skills/a-nach-b/SKILL.md for full API documentation.

---

Directory Structure

This package follows the pi package conventions:

shitty-extensions/
├── package.json         # Declares extensions in "pi" field + "pi-package" keyword
├── extensions/          # Auto-discovered extensions (.ts files)
│   ├── branch-sessions.ts
│   ├── clipboard.ts
│   ├── cost-tracker.ts
│   ├── flicker-corp.ts
│   ├── funny-working-message.ts
│   ├── handoff.ts
│   ├── loop.ts
│   ├── memory-mode.ts
│   ├── oracle.ts
│   ├── plan-mode.ts
│   ├── resistance.ts
│   ├── speedreading.ts
│   ├── status-widget.ts
│   ├── ultrathink.ts
│   └── usage-bar.ts
├── skills/              # Auto-discovered skills (SKILL.md folders)
│   └── a-nach-b/
│       ├── SKILL.md     # Skill definition & API docs
│       ├── search.sh
│       ├── departures.sh
│       ├── route.sh
│       └── disruptions.sh
└── README.md

---

License

MIT