@talex-touch/touch-pie

One-command Talex Touch Pi experience package.

Install

npm install -g @talex-touch/touch-pie

The global install creates pie / touch-pie command shims, saves an uninstall restore point, and adds the shim directory to user PATH. Open a new terminal, then run:

touch-pie

This installs the package into Pi, creates a backup/restore point, installs a safe default AGENTS.md only when missing, removes conflicting old pi-powerline-footer / zlab-weixin-bridge / @narumitw/pi-plan-mode packages from settings, sets quietStartup: true, refreshes the persistent commands, prints a first-run change notice, and verifies the setup.

After install, use:

pie
pie --help
pie -p "hello"
pie touchx info
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.
• Real effective thinking level badge.
• Effort / thinking level switching with Ctrl+Alt+E, /effort, and the footer badge.
• Dynamic shimmer for think:xhigh and think:ultra.
• Quiet WeChat bridge startup.
• TouchX account, subscription, quota, and masked API key usage via pie touchx info or /touchx-sub status.
• /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.
• Built-in Plan mode with image reading and instant Shift+Tab toggle.
• Safe default AGENTS.md template installed only when the user has no global agent instructions.
• Tool-output preference via /tool-output; active renderer ownership stays with dedicated extensions such as pi-tool-display.
• 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
pie touchx info
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:

/about
/touch-pie                 # tabbed settings center
/touch-pie reload
/pie-settings               # same tabbed settings center
/pie-reload
/persona
/persona salutation 老板
/persona tone professional|friendly|cute
/persona reset
/tool-output
/tool-output compact
/tool-output hidden
/tool-output normal

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, move Pi's thinking-cycle keybinding to Ctrl+Shift+E, 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.
• 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.
• 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 prefers Pi's package updater (pi update --extension npm:@talex-touch/touch-pie) and only falls back to npm global sync if that fails.
• /tool-output only records Touch Pie's output preference and does not override built-in tool renderers, so it can coexist with Atuin and pi-tool-display.
• Touch Pie does not modify Pi core or installed package dist files.
• Backup avoids token, cache, history, and log directories.