@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.
• Large centered startup splash screen, customizable with /persona.
• Startup message and live clock, with the message customizable through local persona settings.
• Animated colorful border.
• 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.
• CLI for setup, verify, backup, rollback, and daily pie usage.

Commands

touch-pie
pie [pi args...]
pie update
pie touchx info
touch-pie install --apply-core-patch
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 setup --write-settings --apply-core-patch
touch-pie verify
touch-pie verify --core-patch
touch-pie rollback --backup <manifest-path>

In Pi TUI:

/about
/persona
/persona title Talexs
/persona message Powered by TaGzxia.
/persona salutation 老板
/persona tone professional|friendly|cute
/persona reset

Safety

• postinstall only creates command shims, saves a restore point, and updates user PATH; it does not modify Pi settings, AGENTS, core files, tokens, or history.
• 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+Alt+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.
• PATH changes require explicit --update-path and apply to user PATH/profile only.
• Core patch requires explicit --apply-core-patch and validates Pi core version/signatures.
• Backup avoids token, cache, history, and log directories.