pi-worktrunk

A Worktrunk extension for pi

Package details

← Back
extension

Install pi-worktrunk from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-worktrunk
Package
pi-worktrunk
Version
0.1.0
Published
Apr 14, 2026
Downloads
113/mo · 5/wk
Author
mavam
License
MIT
Types
extension
Size
4.4 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./worktrunk.ts"
  ]
}

Security note

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

README

🚦 pi-worktrunk

A pi extension that updates Worktrunk branch markers via wt so wt list shows whether pi is currently working or waiting for input.

📦 Install

Just one command:

pi install npm:pi-worktrunk

✨ What it does

  • Sets the current branch marker to 💬 when pi starts and whenever pi becomes idle again
  • Switches the marker to 🤖 while pi is actively working on a prompt
  • Clears the marker on shutdown so wt list does not accumulate stale status
  • Fails quietly when wt is unavailable or the current directory is not managed by Worktrunk

👀 Preview

A tiny status badge with disproportionate emotional value:

wt list
+ feature-auth      ↑ 🤖              ↑1               ../repo.feature-auth
+ review-copy     ? ↑ 💬              ↑1               ../repo.review-copy

✅ Requirements

  • wt must be installed and available on your PATH
  • The current repository should be managed by Worktrunk for markers to appear in wt list

🧠 How it works

The extension maps pi lifecycle events to Worktrunk markers:

  • session_start → 💬
  • agent_start → 🤖
  • agent_end → 💬
  • session_shutdown → clear marker

📄 License

MIT