shitty-extensions

Custom extensions and skills for pi coding agent

Package details

← Back

extension

Install shitty-extensions from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:shitty-extensions

Package: shitty-extensions
Version: 1.0.9
Published: Feb 2, 2026
Downloads: 192/mo · 55/wk
Author: hjanuschka
License: MIT
Types: extension
Size: 236.3 KB
Dependencies: 0 dependencies · 4 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/clipboard.ts",
    "./extensions/cost-tracker.ts",
    "./extensions/flicker-corp.ts",
    "./extensions/funny-working-message.ts",
    "./extensions/handoff.ts",
    "./extensions/loop.ts",
    "./extensions/memory-mode.ts",
    "./extensions/oracle.ts",
    "./extensions/plan-mode.ts",
    "./extensions/resistance.ts",
    "./extensions/speedreading.ts",
    "./extensions/status-widget.ts",
    "./extensions/ultrathink.ts",
    "./extensions/usage-bar.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

shitty-extensions

Custom extensions and skills for pi coding agent.

Requires pi 0.50.0+ | npm | GitHub

Installation
Available Extensions
- 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.

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.

clipboard.ts

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

Tool

Tool	Description
`copy_to_clipboard`	Copy text to clipboard (available to the LLM)

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

Command	Description
`/oracle <prompt>`	Ask for a second opinion with model picker
`/oracle -m gpt-4o <prompt>`	Direct query to specific model
`/oracle -f file.ts <prompt>`	Include file(s) in context

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

Provider	Models
OpenAI	gpt-4o, gpt-4o-mini, gpt-4.1, gpt-4.1-mini, o1, o1-mini, o3-mini
OpenAI Codex	gpt-5.2-codex, codex-mini
Google	gemini-2.0-flash, gemini-2.5-flash, gemini-2.5-pro
Anthropic	claude-sonnet-4-5, claude-opus-4, claude-haiku-3-5

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

Command	Description
`/mem <instruction>`	Save an instruction to AGENTS.md
`/remember <instruction>`	Alias for `/mem`

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

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

plan-mode.ts

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

Commands

Command	Description
`/plan`	Toggle plan mode on/off
`/todos`	Show current plan todo list

Keyboard Shortcuts

Shortcut	Action
`Shift+P`	Toggle plan mode

CLI Flags

Flag	Description
`--plan`	Start session in plan mode

handoff.ts

Transfer context to a new focused session.

Commands

Command	Description
`/handoff <goal>`	Generate a context-aware prompt for a new session

usage-bar.ts

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

Commands

Command	Description
`/usage`	Show usage statistics popup

Supported Providers

Provider	Metrics Shown	Auth Source
Claude	5h window, Week, Sonnet/Opus	pi auth, macOS Keychain
Copilot	Premium, Chat	pi auth, `gh auth token`
Gemini	Pro quota, Flash quota	pi auth (`google-gemini-cli`)
Codex	5h window, Day, Credits	pi auth (`openai-codex`)
Kiro	Credits, Bonus credits	`kiro-cli`
z.ai	Token limits, Monthly	`Z_AI_API_KEY` env or pi auth

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

Command	Description
`/ultrathink`	Trigger the rainbow animation

Keyboard Shortcuts

Shortcut	Action
`Ctrl+U`	Trigger ultrathink

status-widget.ts

Persistent provider status indicator in the footer.

Commands

Command	Description
`/status`	Toggle status widget on/off
`/status-refresh`	Force refresh status now

cost-tracker.ts

Analyze spending from pi session logs.

Commands

Command	Description
`/cost`	Show spending for last 30 days
`/cost <days>`	Show spending for last N days

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

Command	Description
`/speedread`	Speed read the last AI response (default)
`/speedread <text>`	Speed read provided text
`/speedread -c`	Speed read from clipboard
`/speedread -l`	Speed read last AI response (explicit)
`/speedread -wpm 500`	Set words per minute (default: 400)

Keyboard Shortcuts

Shortcut	Action
`Ctrl+R`	Speed read last AI response

Controls (in reader)

Key	Action
`SPACE`	Play/pause
`←` / `→`	Seek ±1 word
`[` / `]`	Jump ±10 words
`↑` / `↓`	Adjust speed (±25 WPM)
`B`	Toggle big ASCII art font
`R`	Restart
`Q` / `ESC`	Quit

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

Command	Description
`/loop`	Open loop mode selector
`/loop tests`	Loop until tests pass
`/loop custom <condition>`	Loop until custom condition met
`/loop self`	Agent decides when to stop

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

Command	Description
`/flicker-corp`	Toggle the flicker experience
`/signature-flicker`	Alias for flicker-corp

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

Command	Description
`/resistance`	Toggle the resistance transmission

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

Script	Description
`search.sh`	Find stations/stops by name
`departures.sh`	Get real-time departures
`route.sh`	Plan a trip between locations
`disruptions.sh`	List service disruptions

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)
│   ├── 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

shitty-extensions

Table of Contents

Installation

Via pi install (recommended)

Try without installing

Project-local installation

Manual installation

Available Extensions

clipboard.ts

Tool

Features

Example Usage

oracle.ts

Commands

Features

Supported Models

Example Flow

memory-mode.ts

Commands

Features

plan-mode.ts

Commands

Keyboard Shortcuts

CLI Flags

handoff.ts

Commands

usage-bar.ts

Commands

Supported Providers

Features

ultrathink.ts

Commands

Keyboard Shortcuts

status-widget.ts

Commands

cost-tracker.ts

Commands

speedreading.ts

Commands

Keyboard Shortcuts

Controls (in reader)

Features

Example

loop.ts

Commands

Features

flicker-corp.ts

Commands

resistance.ts

Commands

Features

The Message

Available Skills

a-nach-b

What it does

Example queries

Included scripts

Directory Structure

License