Agent Stuff

This repository is sbusso's personal setup manager for agent skills, extensions, themes, commands, and local helper tooling.

It is the source of truth for my local agent environment. The repo keeps my own assets in one place and installs upstream skill bundles without duplicating them into the local user skill directory.

What This Repo Manages

• local skills in skills
• local extensions in extensions
• local themes in themes
• local commands in commands
• sync configuration and install/update entrypoints
• curated upstream skill bundles

Upstream Sources And Credits

This repo is customized from the original author setup and intentionally preserves credit rather than pretending imported work is original.

• Original author reference: Armin's mitsupi setup, which this repo was forked from and adapted for personal use
• Workflow/process skills: obra/superpowers
• Cloudflare platform skills: cloudflare/skills

Imported upstream skills should remain credited to their source repositories in documentation and config.

Install And Update

Use the repo-managed entrypoints:

./scripts/install
./scripts/update

Both commands support installing into an alternate target root:

AGENT_STUFF_TARGET_ROOT=/path/to/target ./scripts/install
AGENT_STUFF_TARGET_ROOT=/path/to/target ./scripts/update

The upstream and local sync rules live in config/sources.json.

The install flow keeps responsibilities separate:

• local assets are copied into ~/.pi/agent
• upstream bundles are linked under ~/.agents/skills

This avoids skill collisions between your local skills and separately installed upstream bundles.

Skills

Local skills live in the skills folder:

• /commit - Create git commits using concise Conventional Commits-style subjects.
• /frontend-design - Design and implement distinctive frontend interfaces.
• /github - Interact with GitHub using the gh CLI (issues, PRs, runs, APIs).
• /librarian - Cache and refresh remote git repositories in ~/.cache/checkouts.
• /native-web-search - Trigger native web search with concise summaries and source URLs.
• /openscad - Create/render OpenSCAD models and export STL files.
• /pi-share - Load and parse session transcripts from shittycodingagent.ai/buildwithpi/pi.dev URLs.
• /self-update - Refresh this local setup through the repo-managed update flow.
• /sentry - Fetch and analyze Sentry issues, events, transactions, and logs.
• /summarize - Convert files/URLs to Markdown via uvx markitdown and summarize.
• /tmux - Drive tmux sessions via keystrokes and pane output scraping.
• /update-changelog - Update changelogs with notable user-facing changes.
• /uv - Use uv for Python dependency management and script execution.
• /web-browser - Browser automation via Chrome/Chromium CDP.

Pi Coding Agent Extensions

Custom extensions for Pi Coding Agent are in extensions:

• answer.ts - Interactive TUI for answering questions one by one.
• btw.ts - Simple /btw side-chat popover with optional summary injection back into the main chat on close.
• context.ts - Context breakdown (extensions, skills, AGENTS.md/CLAUDE.md) + token usage, including loaded-skill highlighting.
• control.ts - Session control helpers (list controllable sessions, etc.).
• files.ts - Unified file browser with git status + session references and reveal/open/edit/diff actions.
• go-to-bed.ts - Late-night safety guard with explicit confirmation after midnight.
• loop.ts - Prompt loop for rapid iterative coding with optional auto-continue.
• notify.ts - Native desktop notifications when the agent finishes.
• plan-mode - Official Pi plan-mode extension for read-only exploration and plan execution workflows.
• prompt-editor.ts - In-editor prompt mode selector with persistence, history, config, and shortcuts.
• review.ts - Code review command (working tree, PR-style diff, commits, custom instructions, optional fix loop).
• session-breakdown.ts - TUI for 7/30/90-day session and cost analysis with usage graph.
• split-fork.ts - /split-fork command to branch the current session into a new pi process in a right-hand Ghostty split.
• ssh.ts - Official Pi SSH remote execution extension for read/write/edit/bash delegation.
• subagent - Official Pi subagent extension with bundled agents and workflow prompts.
• todos.ts - Todo manager extension with file-backed storage and TUI.
• uv.ts - Helpers for uv-based Python workflows.
• whimsical.ts - Replaces the default thinking message with random whimsical phrases.

Pi Coding Agent Themes

Custom themes are in themes:

• nightowl.json - Night Owl-inspired theme.

Plumbing Commands

These command files need customization before use. They live in plumbing-commands:

• /make-release - Automates repository release with version management.

Legacy Packaging

The distributions directory is currently retained as legacy packaging from the forked setup. It is no longer the primary installation path for this repo.

Intercepted Commands

Command wrappers live in intercepted-commands:

• pip
• pip3
• poetry
• python
• python3