A set of extensions for the Pi coding agent, tmustier/pi-extensions enhances productivity by adding features for in-terminal file management, task monitoring, model interaction, and usage analytics. It targets users of the Pi agent seeking to augment its core functionality with practical, workflow-improving tools, enabling a more seamless and efficient development experience.

How It Works

This project comprises modular extensions that integrate directly with the Pi coding agent. Each extension introduces specific capabilities, such as an integrated file browser (/readfiles), visual status indicators for terminal sessions (tab-status), utilities for managing long-running processes (pi-ralph-wiggum), and tools for code snippet manipulation (/code, /paste). Users can selectively enable these extensions to customize the Pi agent's behavior and tailor it to their specific development needs.

Quick Start & Requirements

Installation is performed using the Pi package manager: pi install git:github.com/tmustier/pi-extensions. For users who prefer to install only a subset of extensions, the packages entry in ~/.pi/agent/settings.json can be modified. If a local clone is maintained, extensions can be added to ~/.pi/agent/settings.json using their respective file paths. The agent-guidance extension necessitates an additional setup script: cd ~/pi-extensions/agent-guidance && ./setup.sh.

Highlighted Details

• /readfiles: Provides an in-terminal file browser and viewer, allowing navigation, diff viewing, and sending comments to the agent without leaving the terminal environment.
• tab-status: Displays visual indicators (✅ done, 🚧 stuck, 🛑 timed out) for managing multiple parallel terminal sessions.
• pi-ralph-wiggum: Designed to run arbitrarily long tasks without diluting the agent's attention, suitable for extended development loops.
• agent-guidance: Enables switching between models like Claude, Codex, and Gemini, incorporating model-specific guidance files for optimized interaction.
• /usage: Offers a dashboard for tracking costs, tokens, and messages across different providers and models over various timeframes.
• arcade: Includes minigames such as sPIce-invaders, picman, ping, tetris, and mario-not, playable during background tasks like test execution.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord/Slack), or project roadmaps were found in the provided README.

Licensing & Compatibility

The license type and any compatibility notes relevant to commercial use or linking with closed-source projects are not specified in the provided README.

Limitations & Caveats

This repository is a collection of extensions specifically designed for the Pi coding agent and is not a standalone project. The agent-guidance extension requires an additional setup step via its setup.sh script. Some extensions, like pi-ralph-wiggum, are described as simplified "flat versions," which may indicate design trade-offs for enhanced usability.