Lelezonio Pi Kit

Personal Pi kit containing global extensions, themes, and bootstrap config.

Each extension is published as its own Pi extension entry so it can be enabled, disabled, or filtered independently.

Extensions

lelezonio-pi-kit

Adds /setup and /preset for managing which extensions from this personal Pi kit are loaded. /setup opens a checkbox-style menu: use arrow keys to navigate, Space to toggle extensions, Enter or s to save and reload, a for all extensions, m for the minimal profile, and Esc to cancel. The kit manager keeps itself enabled so you cannot lock yourself out.

Commands:

• /setup — open the extension checkbox menu.
• /setup status — show enabled/disabled kit extensions, package source, stale filters, and missing files.
• /setup doctor or /doctor — run a setup health check.
• /setup enable <extension> — enable one extension and reload.
• /setup disable <extension> — disable one extension and reload.
• /setup toggle <extension> — toggle one extension and reload.
• /setup full — enable every kit extension and reload.
• /setup minimal — enable the minimal default set and reload.
• /setup save <name> — save the current extension selection as a preset.
• /setup use <name> — apply a preset by name and reload.
• /setup list — list built-in and saved presets.
• /setup delete <name> — delete a saved preset.
• /preset — choose a setup preset from a picker.
• /preset <name> — apply a setup preset by name.
• /preset save <name> — save the current extension selection as a preset.
• /preset delete <name> — delete a saved preset.

checkpoint

Adds manual checkpoints that label the current Pi session leaf and, in git repositories, store a tracked-file snapshot under dedicated refs/pi-checkpoints/ refs without changing the working tree or polluting git stash list. The newest 100 git snapshots per repository are retained; older session labels remain available for conversation navigation. Use this before risky refactors or agent runs.

Commands:

• /checkpoint [label] — create a session/git checkpoint.
• /checkpoint list — list checkpoints from the current session.
• /checkpoint restore <number|label> — apply the stored git snapshot back onto the current working tree.

codex-switcher

Adds /codex for saving and switching between ChatGPT/Codex OAuth accounts. It stores account profiles in ~/.pi/agent/codex-accounts.json (contains OAuth tokens; keep private), updates Pi's openai-codex credentials, and mirrors the matching Codex CLI auth file when available.

Commands:

• /codex — pick a saved Codex account from a selector.
• /codex save <name> — save the currently logged-in Codex account.
• /codex use <name> or /codex <name> — switch to a saved account.
• /codex list — list saved accounts.
• /codex current — show the current account marker without exposing tokens.
• /codex delete <name> — remove a saved account profile.

Typical setup: run /login openai-codex, /codex save personal, log into the second account, then /codex save work.

diff

Tracks files changed during the last agent run. It records the git status baseline at agent start, watches edit/write tool results, and reports changed files when the run ends. /diff opens an interactive changed-file picker and opens the selected file in Zed. It also owns /zed for opening the current working directory in Zed.

Commands:

• /diff — choose a changed file and open it in Zed.
• /diff list — print the tracked changed files.
• /diff clear — clear the tracked list and reset the git baseline.
• /zed — open the current directory in Zed.

git-pr

Adds a guarded GitHub pull request workflow. /git <target-branch> gathers read-only git snapshots, then sends the agent a structured PR workflow prompt that requires an explicit base branch, commit planning, PR description approval, push, and gh pr create --base <target-branch>. It also blocks gh pr create tool calls that omit --base, and asks before allowing a base branch different from the last /git target for that repo.

Commands:

• /git <target-branch> — plan commits, push, and create a GitHub PR against the target branch.
• /yeet [instructions] — add, inspect, commit, and push current repository changes.

handoff

Generates a markdown handoff document from the current session, writes it under the OS temp directory, and starts a fresh linked Pi session with a reviewed startup prompt pointing at that handoff file.

Commands:

• /handoff <next goal> — create a handoff and open a new session ready to continue.
• /handoff — prompt for the next-session goal.

orchestrator

Adds /agent for selecting a foreground agent and shows a compact above-editor agent panel with the active foreground agent. Foreground agents are normal agent .md files with role: foreground or role: both; they can restrict callable background subagents with background_agents. If no agents are marked foreground, all discovered agents are selectable so names/themes can be changed freely. This replaces the older team/chain/mode workflow: foreground agents own the conversation, and background agents are invoked through the subagent tool.

Bundled foreground agents:

• planner — writes implementation plans under .plans/.
• worker — everyday foreground development agent.
• plan-runner — implements existing .plans/ plans.
• builder — autonomous plan-and-implement foreground agent.

Bundled background agents:

• explorer — merged code explorer, docs/web researcher, and non-text asset inspector.
• advisor — pre-planning consultant.
• critic — post-plan/post-implementation reviewer.
• coder — focused background implementation agent.

Agent frontmatter:

---
name: worker
role: foreground
description: Everyday foreground agent
tools: read,write,edit,bash,subagent
background_agents: explorer, advisor, critic, coder
model: openai-codex/gpt-5.6-luna
thinking: max
---

Commands:

• /agent — pick a foreground agent.
• /agent <name> — switch directly to a foreground agent.
• /agent status — show active foreground/background agents and tools.
• /agent details — toggle the optional agent panel line with background agents and active tools.
• /agent off — disable foreground agent mode and return to normal Pi tools.

pi-ui

Installs a custom Pi terminal UI with a responsive Pi header, configuration-aware shortcut hints, model/provider/thinking display, clickable path and git branch status, session name and extension statuses, session cost/context usage, a one-line last-user-message footer, custom editor border colors, fixed editor layout support, and live working-phase/duration feedback. When the RunCat font is installed, the fixed-editor activity border animates it and replaces Pi's redundant built-in working row. It also adds an editor text stash shortcut.

Commands:

• /pi-ui — enable the custom header/footer and fixed editor for the current session.
• /pi-ui-safe — keep the custom header/footer while using Pi's standard editor.
• /pi-ui-builtin — restore Pi's built-in header/footer/editor UI for the current session.

Set PI_UI_FIXED_EDITOR=0 to start in safe mode by default. Set PI_UI_RUNCAT=0 to hide RunCat, or PI_UI_RUNCAT=1 to enable it when your terminal uses the RunCat font. Header branding uses the active theme's semantic colors by default; set PI_UI_GRADIENT=1 to opt into the animated per-character gradient.

Shortcuts:

• Alt+S — stash the current editor text; press again with an empty editor to restore it.

usage-bar

Adds an interactive /usage overlay with AI provider quota bars, reset countdowns, plan details, and provider status indicators for Claude, GitHub Copilot, OpenCode Go, and Codex/OpenAI where credentials are available.

Commands:

• /usage — show usage/quota bars and provider status. Press any key to close.

theme-cycler

Cycles installed themes without using Ctrl+Shift shortcuts that are commonly intercepted by Zed or terminal hosts. /theme opens a selector that previews themes in memory as you move through the list, without rewriting settings; Enter persists the previewed theme and Esc restores the previous theme. Override the defaults with PI_THEME_NEXT_SHORTCUT and PI_THEME_PREVIOUS_SHORTCUT if needed.

Commands and shortcuts:

• /theme — choose a theme from a picker.
• /theme <name> — switch directly to a theme.
• Alt+] — next theme.
• Alt+[ — previous theme.

pwsh-user-bash

Replaces Pi's user ! shell backend with PowerShell 7 on Windows-oriented setups. It runs pwsh directly, avoids the local Git Bash wrapper, keeps startup non-interactive, and optionally sources a dedicated Pi profile before each command.

Environment variables:

• PI_USER_BASH_PWSH or PI_USER_BASH_SHELL — override the PowerShell executable path.
• PI_USER_BASH_PWSH_PROFILE — override the profile script sourced before commands. Defaults to $HOME/.config/powershell/pi-profile.ps1.

scratchpad

Adds persistent pinned session notes as an above-editor widget. Notes are stored in ~/.pi/agent/scratchpad.json and can be shown, hidden, listed, added, removed, or cleared.

Commands:

• /note add <text> or /note pin <text> — pin a note and show the scratchpad.
• /note rm <n> — remove note number n.
• /note clear — remove all notes.
• /note toggle — show or hide the widget.
• /note list or /note — list notes.

Shortcuts:

• Alt+N — toggle scratchpad visibility.

Included theme:

• github-dark-default

Install on a new machine

Install Pi first:

npm install -g @earendil-works/pi-coding-agent

Then install this kit from npm:

npx lelezonio-pi-kit

Alternatively, with Pi's package manager:

pi install npm:lelezonio-pi-kit

The npm bootstrap also adds these packages to ~/.pi/agent/settings.json:

• npm:pi-hermes-memory
• npm:pi-extmgr
• npm:pi-simplify - reviews recently changed code for clarity, consistency, and maintainability.
• npm:lelezonio-pi-kit
• npm:@juicesharp/rpiv-ask-user-question - lets the model ask structured clarification questions instead of guessing.
• npm:pi-runcat - ships the optional RunCat font and fallback working indicator; pi-ui moves the cat into its fixed-editor activity border when the font is installed and available.

Development checks

npm ci
npm run typecheck
npm test

The test suite covers package paths, theme contrast, agent parsing, fixed-editor layout, terminal paint sequences, and shortcut handling.

Publishing

Pushing to main automatically bumps package.json by one patch version, commits/tags that release, and publishes npm:lelezonio-pi-kit.

Repository setup required once: add an NPM_TOKEN repository secret with publish access for the package. Add [skip npm] to a commit message to skip the publish workflow.