Agent Stuff

Extensions, skills, and themes for Pi, the coding agent.

Note: These are tuned for my workflow. They may need modification for yours.

Installation

Install from git (extensions, skills, and themes are all discovered automatically):

pi install git:github.com/kostyay/agent-stuff

To try a single extension without installing the full package:

pi -e ./pi-extensions/status-bar.ts

Extensions

All extensions live in pi-extensions/. Each file is a self-contained Pi extension — one responsibility per file, no cross-extension dependencies.

Extension	Description
answer.ts	Extracts questions from assistant responses and presents an interactive TUI for answering them one by one
clear.ts	/clear command — starts a new session (alias for /new)
commit.ts	/commit command — stages all changes, generates a Conventional Commits message via LLM, creates a side branch if on the default branch
context.ts	/context command — shows loaded extensions, skills, AGENTS.md/CLAUDE.md, and token usage
control.ts	Session control via Unix domain sockets for inter-session communication
files.ts	/files command — file browser merging git status with session-referenced files, plus diff/edit actions
git-rebase-master.ts	/git-rebase-master command — fetches latest main/master and rebases current branch with automatic LLM conflict resolution
kbrainstorm.ts	ask_question tool — interactive TUI for brainstorming with multiple-choice and freeform answers
loop.ts	/loop command — runs a follow-up prompt loop with a breakout condition for iterative coding
notify.ts	Desktop notifications (OSC 777) when the agent finishes and is waiting for input
plan.ts	/plan command — read-only planning mode that restricts tools and walks through a structured plan
prompt-editor.ts	Prompt mode selector (default/fast/precise) with per-mode model & thinking persistence
review.ts	/review command — code review for uncommitted changes, PRs, or specific commits with optional auto-fix loop
sandbox/	OS-level sandboxing for bash commands via sandbox-exec (macOS) / bubblewrap (Linux) with configurable filesystem and network restrictions
session-breakdown.ts	/session-breakdown command — analyzes session usage (cost by model) with a GitHub-style activity graph
simplify.ts	/simplify command — detects the dominant language of uncommitted changes and runs the matching code-simplifier skill
status-bar.ts	Rich two-line footer with model, context meter, token counts, cost, git status, and tool tally
todos.ts	File-backed todo manager with a TUI for listing and editing todos
whimsical.ts	Replaces "Thinking..." with random phrases like "Reticulating splines..." and "Consulting the void..."

Skills

Skills live in skills/. Each skill has a SKILL.md that the agent reads when the task matches.

Skill	Description
github	GitHub interactions via the gh CLI (issues, PRs, runs, API)
go-code-simplifier	Simplify and refine Go code for clarity and maintainability (Go 1.26+)
js-code-simplifier	Simplify and refine JavaScript/TypeScript code for clarity and maintainability
kbrainstorm	Collaborative brainstorming — explores intent, requirements, and design before implementation
kchangelog	Executive-style changelog entries tracked by branch, auto-promoted on release
mermaid	Create and validate Mermaid diagrams with the Mermaid CLI
native-web-search	Quick web research with concise summaries and source URLs
pi-share	Load and parse session transcripts from buildwithpi.ai URLs
pr-update	Update or create a pull request for the current branch with diff-based descriptions
py-code-simplifier	Simplify and refine Python code for clarity and maintainability
summarize	Convert URLs or files (PDF/DOCX/HTML) to Markdown via markitdown, with optional summarization
tmux	Remote-control tmux sessions by sending keystrokes and scraping pane output
web-browser	Browser automation via Chrome DevTools Protocol (clicking, forms, navigation)

Themes

Custom themes live in pi-themes/.

Theme	Description
nightowl.json	Night Owl color scheme

Project Structure

├── .github/           # CI workflows and release scripts
├── pi-extensions/     # Pi extensions (auto-discovered)
├── skills/            # Agent skills (SKILL.md per skill)
├── pi-themes/         # Custom themes
├── plumbing-commands/ # Release automation templates
├── Makefile           # Release and changelog targets
├── AGENTS.md          # Agent-facing coding conventions
├── CHANGELOG.md       # Release history
└── package.json       # Pi package manifest

License

Personal use. No warranty.