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:[email protected]:kenxcomp/yoyo-pi.git

Temporary test without installing:

pi -e git:[email protected]: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:[email protected]:kenxcomp/[email protected].

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.