yoyo-pi

A polished extension pack for pi that makes the terminal coding-agent workflow faster, cleaner, and more ergonomic.

This is Kenx's daily pi setup, packaged as a reusable GitHub install: Vim-style prompt editing, custom TUI themes and status bars, Grok-style agent-status variants, right-side file/todo overlays, interactive choice pickers, context snapshots, and a read-only planning mode.

Highlights

• Vim prompt editing — toggle /vim for normal/insert/visual-style prompt control, with a status pill and external-editor fallback.
• Custom TUI chrome — switch themes, full-screen background coverage, and eight status bar/input layouts with /theme, /theme-bg, and /switch-statusbar.
• Grok-style agent status — /switch-agentStatus <1-9|v1-v9> switches among nine terminal-native thinking/executing/reading/writing readouts with the latest assistant text or latest tool log and current file, while edit/write renderers hide diffs and file contents. Hidden thinking placeholders are suppressed while this UI is enabled.
• Socratic QA workflow — /qa-agent <question> lives inside the existing gr0k-hack extension and asks clarifying questions before delegating to qa-knowledge, qa-web-research, and qa-critic subagents for truth-seeking synthesis.
• File tree / todo overlays — open a right-side file picker with /filetree or Ctrl+Shift+F; monitor .plan/*.jsonl todos with /todo or Ctrl+Shift+T.
• Agent-friendly choice pickers — single_choice, multiple_choice, and choice_questions give models structured ways to ask users for decisions.
• Context snapshots — /clear saves the current branch context, then /restore <name> brings it back later.
• Plan mode — /plan exposes a sandboxed plan_agent that writes implementation plans and todos under .plan/, previews the plan before exit, and carries forward only the original prompt plus plan context after approval.

Preview

Status bar & input variations

Interactive HTML preview: open the status bar playground.

Agent status variations

Interactive HTML preview: open the agent status playground.

Direct jumps: V1 · V2 phase tag · V3 · V4 · V5 · V6 · V7 · V8 · V9.

File tree overlay

Todo timeline sidebar

Choice pickers

Install

From npm after publishing:

pi install npm:yoyo-pi

Or install directly from GitHub:

pi install git:git@github.com:kenxcomp/yoyo-pi.git

Temporary test without installing:

pi -e git:git@github.com:kenxcomp/yoyo-pi.git

The unpinned Git URL follows main when you run pi update. Pin a tag only when you want a reproducible release, for example git:git@github.com:kenxcomp/yoyo-pi.git@v0.1.5.

After installing this package, remove or move the old local copies under ~/.pi/agent/extensions/ to avoid duplicate slash commands.

Commands and tools

Area	Commands / tools	What it adds
Context snapshots	/clear, /restore <name>	Save current branch context to .tmp/<name>.jsonl and restore it later.
Vim prompt mode	/vim [on|off|status]	Vim-like modal prompt editor with external-editor fallback.
Choice pickers	single_choice, multiple_choice, choice_questions, /choice-demo [multi|questions]	Inline-pill single select, compact multi-select, and tabbed batched questions.
TUI infrastructure	/theme <paper|light|dark>, /theme-bg <true|false>, /filetree, Ctrl+Shift+F, /switch-statusbar <1-8|0>	Themes, optional full-TUI background fill, right-side overlay file picker, and custom statusbar/input UI. Runtime preferences are stored under ~/.pi/agent/state/kenx-infra.json.
Agent status UI	/switch-agentStatus <1-9|v1-v9|0|off|status>	Nine Grok-style status widgets for thinking/executing/reading/writing plus compact built-in tool renderers. V2 uses a meaningful [agent] phase tag instead of a fake step count. See the HTML playground for matching previews. Edit/write show changed file names only; diffs, file contents, and duplicate hidden-thinking placeholders are hidden. Preferences are stored under ~/.pi/agent/state/gr0k-hack.json.
gr0k-hack QA	/qa-agent <question>, subagent, qa_web_search	Socratic QA workflow inside extensions/gr0k-hack/: clarify first, then run bundled extensions/gr0k-hack/agents/qa-*.md agents (qa-knowledge with no tools, qa-web-research with only qa_web_search, and qa-critic with no tools). qa_web_search is read-only and may require JINA_API_KEY/JINA_AUTH_TOKEN; it falls back to DuckDuckGo HTML or reports provider limitations clearly.
Plan/todo workflow	/plan, /todo <goal>, /todo [show|off|status], Ctrl+Shift+T, plan_agent	Read-only plan mode delegates planning to agents/plan-agent.md; before exiting it displays the plan and asks whether to execute, shelve, or revise. Approved exits prune active LLM context to the original prompt plus plan handoff; todo mode writes/monitors .plan/todo.jsonl and asks the agent to keep statuses updated while executing.

Development

This package intentionally lists Pi core packages as optional peerDependencies because Pi provides them at runtime.

The pi.extensions manifest explicitly lists entrypoints so extensions/plan-mode/sandbox.ts is not auto-loaded as a normal extension; it is only loaded by the child plan-agent process. The QA workflow is part of ./extensions/gr0k-hack/index.ts; helper modules and bundled prompts under extensions/gr0k-hack/agents/ should not be added as separate pi.extensions entries.

If a running Pi session loads npm:yoyo-pi or a git package cache instead of this worktree, reinstall/sync that package or start Pi with the local path, then run /reload before validating new gr0k-hack commands/tools.