@talex-touch/touch-pie

One-command Talex Touch Pi experience package.

Install

npm install -g --ignore-scripts @earendil-works/pi-coding-agent@latest
npm install -g @talex-touch/touch-pie@latest
touch-pie

The first command installs the latest Pi release without package lifecycle scripts. touch-pie also refreshes Pi to npm latest before installing the Touch Pie extension package, so a stale or missing Pi installation is repaired automatically.

Setup creates pie / touch-pie command shims, saves an uninstall restore point, adds the shim directory to user PATH, installs a safe default AGENTS.md only when missing, removes known conflicting legacy packages, sets quietStartup: true, and verifies the result.

After install, use:

pie
pie --help
pie -p "hello"
pie update

Local development:

node /absolute/path/to/pi-experience-kit/packages/touch-pie/bin/touch-pie.mjs

What It Includes

• Customized powerline footer and startup welcome.
• Compact Pie Code startup summary with model, subscription/billing state, and current path.
• Expanded welcome panel with tips, loaded resources, and recent sessions.
• Tabbed Touch Pie settings via /touch-pie or /pie-settings, with Native Pi settings as a second-level tab.
• Touch Pie reload via /touch-pie reload or /pie-reload while preserving Pi's native /reload.
• Clipboard paste reads text or images through Pi with Ctrl+V, Windows Alt+V, and Cmd+V when the terminal forwards the Command key.
• Real effective thinking level badge.
• Thinking level switching with Shift+Tab, /effort, and the footer badge.
• Dynamic shimmer for think:xhigh and think:max.
• Model loading through Pi's native models/modelRegistry only; Touch Pie does not register a custom provider.
• Bundled subagents inherit the active parent model by default. Agent({ model: "provider/modelId" }) can override an agent's configured model for one invocation, and /agents only offers models available in the current Pi scope.
• Active and safely resumable subagents appear in a below-editor target dock. With an empty editor and no completion menu, press ↓ to cycle directly between Parent and ready child sessions; Alt+[ / Alt+] remain explicit shortcuts. Submitting to a running child interrupts and redirects it, while submitting to a settled child resumes the same valid session in the background. Esc stops a selected running child or returns a settled selection to Parent. Alt+X provides the same targeted stop when the Powerline editor is disabled.
• /update upgrades Pi core and Touch Pie through the same workflow as pie update, then hot-reloads Touch Pie and asks for a restart when the Pi core changed.
• /about shows app, build, author, and base package information without reading runtime .git.
• /persona stores local startup title/message, Agent salutation, and tone in ~/.pi/agent/touch-pie/persona.json.
• Interactive Agent questions through ask_user_question: tabbed question sets, single-select, multi-select, free-form input, and Markdown previews.
• /qna extracts actionable questions from the last complete Agent response through the shared question tool; the guarded automatic fallback is configurable as a global preference in General settings and defaults off.
• Built-in Plan mode with image reading, entered and managed manually through /plan, using the same shared question tool.
• Built-in Goal mode through /goal: reviewable Goal Brief, visible mutable plan, ask-before command gates, non-interrupting side questions, pause/resume, turn budget, and fail-closed completion judging.
• Persistent Todo widgets show the complete task list in source order and wrap long titles to terminal width; the active item alternates between ○ / ● with a restrained monochrome shimmer, Steering messages sit immediately below Todos, and /todos opens a scrollable full-list view when the fixed area is shorter than the list.
• /review [scope] performs a review-only, severity-ranked audit of working-tree changes, staged/unstaged/untracked changes, commits, ranges, or paths.
• Bundled tds-skill for TalexDreamSoul's concise communication style, conservative engineering choices, risk-based testing, Cloudflare delivery, and safe macOS maintenance.
• Bundled generate-image skill for reviewed still-image generation, a 24-item holiday mascot catalog, and consistent PNG-frame/animated-WebP workflows. Generation and review use the optional pi-image-gen companion installed with pi install git:github.com/justhil/pi-image-gen.
• Safe default AGENTS.md template installed only when the user has no global agent instructions.
• Restrained built-in tool rendering uses an icon plus accent-colored Execute, text-colored tool names, and dim arguments without bold text. Non-Bash partial/final previews keep the latest five/three lines, Bash uses a fixed ten-line sliding window, and Ctrl+O expands only the latest tool or prompt-hook detail.
• The default live working row rotates through a shuffled 50-message deck without repeats before exhaustion, while combining elapsed time, response tokens, and effective thinking effort; custom /vibe themes replace only the thinking/generating vocabulary.
• Completed turns use an independent shuffled 32-verb deck for messages such as Crunched for 1m 05s, followed by the existing token, speed, cost, and session summary.
• Any active tool, including third-party tools such as ffgrep and fffind, switches the live working row to a high-contrast shimmer on Executing <tool>..., with one blank row separating it from Jobs/widgets in fixed-editor mode. Touch Pie still leaves third-party result panels to their owning renderer.
• Every built-in Execute <tool> row has a live elapsed indicator, frozen at completion; active rows share one throttled refresh ticker so parallel tools do not multiply terminal redraws. Tool rows remain static while the separate Working/Thinking loader keeps its shimmer animation.
• Language selection via the General settings tab, touch-pie language, or --lang.
• CLI for setup, verify, backup, rollback, and daily pie usage.

Commands

touch-pie
pie [pi args...]
pie update
touch-pie language zh
touch-pie --lang zh doctor
touch-pie doctor
touch-pie backup
touch-pie setup --write-settings
touch-pie setup --write-settings --update-path
touch-pie path --update-path
touch-pie uninstall
touch-pie verify
touch-pie rollback --backup <manifest-path>

In Pi TUI:

/update                       # upgrade Pi core and Touch Pie, then reload extensions
/goal ship the parser        # draft a Goal Brief, then approve and run
/goal status
/goal tasks
/goal ask what changed?
/goal pause
/goal resume
/goal budget 40
/goal cancel
/review                      # staged + unstaged + untracked working tree
/review staged
/review HEAD~1..HEAD
/review packages/touch-pie
/skill:tds-skill              # concise delivery, risk-based testing, Cloudflare, and macOS maintenance
/skill:generate-image         # reviewed stills, holiday variants, and animation frames
/about
/touch-pie                 # tabbed settings center
/touch-pie reload
/pie-settings               # same tabbed settings center
/pie-reload
/qna
/persona
/persona salutation 老板
/persona tone professional|friendly|cute
/persona reset
/tool-output
/tool-output compact
/tool-output hidden
/tool-output normal
/pie-tool-display

Safety

• postinstall only creates command shims, saves a restore point, and updates user PATH; it does not modify Pi settings, AGENTS, core files, installed package dist files, tokens, or history.
• /touch-pie and /pie-settings expose a keyboard-driven, tabbed Touch Pie settings center while preserving Pi's native /settings page as a Native Pi submenu jump.
• /touch-pie reload and /pie-reload reload Touch Pie through extension APIs while preserving Pi's native plain /reload behavior.
• Set TOUCH_PIE_NO_POSTINSTALL=1 to skip postinstall PATH setup.
• setup creates a backup first.
• Settings changes are field-level and only set quietStartup: true, bind Pi's thinking-cycle action to Shift+Tab, plus remove known conflicting legacy package entries.
• Touch Pie owns /plan and --plan; the installer removes the older external @narumitw/pi-plan-mode package to avoid extension conflicts.
• Touch Pie owns /goal and --goal; setup removes pi-until-done and @qhn/pi-goal. Legacy until-done.state session entries are read once and persisted in the new touch-pie.goal.state format.
• Active Goal state is mirrored atomically to .goal/state.json; completion fails closed unless all tasks are settled, verify output is quoted, and the configured or active-model judge approves.
• AGENTS.md is installed only if missing and never overwrites an existing file.
• Persona settings are local-only and limited to startup title/message, salutation, and controlled tone; users cannot edit the full system prompt.
• Automatic Q&A is a global preference and is off by default. When enabled, it runs only after the Agent settles in TUI mode, skips responses that already used ask_user_question, preserves non-empty editor drafts, blocks every non-question tool during extraction, and deduplicates processed responses.
• Global npm postinstall runs touch-pie path --update-path; manual PATH changes also require explicit --update-path and apply to user PATH/profile only.
• pie update and TUI /update use the same updater. Both upgrade Pi core, refresh the Pi package and global CLI, then synchronize Touch Pie settings and command shims.
• /tool-output hidden hides successful built-in result summaries while retaining the call row and all failures; normal and compact keep the compact summary.
• /pie-tool-display explains the Touch Pie rendering model. Touch Pie owns final rendering for built-in tools; other renderer extensions can continue to render their own tool families.
• Touch Pie does not modify Pi core or installed package dist files.
• Backup avoids token, cache, history, and log directories.