@talex-touch/touch-pie

One-command Talex Touch Pi experience kit: startup UI, powerline footer, quiet WeChat bridge, setup, verify, and rollback tools.

Packages

Package details

extension

Install @talex-touch/touch-pie from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@talex-touch/touch-pie
Package
@talex-touch/touch-pie
Version
0.1.17
Published
Jun 12, 2026
Downloads
1,440/mo · 1,440/wk
Author
talexds
License
MIT
Types
extension
Size
780.4 KB
Dependencies
1 dependency · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts",
    "./weixin-bridge.ts",
    "./subagents/src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@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 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 Talexs splash screen.
  • Powered by TaGzxia. and live clock.
  • Animated colorful border.
  • Real effective thinking level badge.
  • Dynamic shimmer for think:xhigh and think:ultra.
  • Quiet WeChat bridge startup.
  • Built-in Plan mode with image reading and Control+Shift+P 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
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>

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 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.
  • 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.