@vanillagreen/pi-task-panel

Persistent Claude-style tasks panel for Pi with slash commands and a structured tasks_write tool.

Packages

Package details

extension

Install @vanillagreen/pi-task-panel from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@vanillagreen/pi-task-panel
Package
@vanillagreen/pi-task-panel
Version
3.0.6
Published
Oct 23, 2026
Downloads
1,389/mo · 462/wk
Author
vanillagreencom
License
MIT
Types
extension
Size
254.3 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/vanillagreencom/kendex/main/pi-extensions/pi-task-panel/assets/panel-expanded.png",
  "extensions": [
    "./extensions/task-panel.ts"
  ],
  "appendSystem": "./instructions.md"
}

Security note

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

README

@vanillagreen/pi-task-panel

A task list above the Pi editor. The agent updates it through a tool, and you can edit it through the tasks command.

Features

  • Show active, pending and completed tasks.
  • Group tasks by phase and show task notes.
  • Edit, import and export the task list.
  • Restore tasks when the session resumes.

Install

  • npm: pi install npm:@vanillagreen/pi-task-panel.
  • kendex: add the declaration below to the project's kendex.toml, or to ~/.config/kendex/kendex.toml for user scope. Run kendex update-pi.
[pi-extensions."@vanillagreen/pi-task-panel"]
source = "kendex"

Restart Pi after installation. Use kendex update-pi --check to preview the installation.

How it works

The agent sends tasks to the tasks_write tool. The extension saves the list with the session and displays it above the editor. Tool calls or your edits update task status and notes. Resuming the session restores the saved list. A list over 64 KiB is saved in a file beside the session rather than in it. The newest such lists are kept up to 32 MiB per session, so moving to an older point with /tree restores the list from that point. Where that file is gone, as in a fork or past the 32 MiB, the panel shows the last list the session holds and warns.

Disk use

The saved lists sit in kendex/sessions/<session>/pi-task-panel/ under the Pi user directory. When a Pi session starts, the extension deletes the files of every session whose working directory is gone, and deletes any of these files older than 5 days. Resuming a session marks its own files as new, so a session resumed after 5 days keeps them. Files saved by version 3.0.5 or earlier follow the 5-day rule from the first session start after the update.

Memory use

The visible panel keeps one rendered layout of at most 65,536 characters. It keeps sorted order for lists of at most 256 tasks. Larger lists sort when layout changes. A task change replaces these caches. Session shutdown removes the widget.

Setup

The settings editor writes project values to .pi/settings.json. The default user file is ~/.pi/agent/settings.json. PI_CODING_AGENT_DIR changes the user directory. Package values are stored under kendex.extensionManager.config["@vanillagreen/pi-task-panel"].

Open /extensions:settings; settings appear under the Task Panel tab. Project settings in .pi/settings.json apply only after Pi marks the workspace trusted.

  • enabled: package toggle.
  • panelDefaultState, maxCompactTasks, showNotesInExpanded, autoShowOnFirstTask, glyphStyle: what the panel shows and when it appears.
  • alternateShortcut, managerShortcut, toggleBehavior, takeoverCtrlT: the shortcuts and what the toggle does; Pi's own thinking-visibility binding is left alone unless you opt in.
  • compactToolOutput: whether tasks_write results render as one line.
  • showWorkflowReminder, showIncompleteReminder: the hidden reminders to the agent.

Maintainer notes are in DEVELOPMENT.md.

Licence

MIT