@howaboua/pi-auto-trees

A Pi package that adds /marker and /end commands for incremental long-running coding sessions.

Packages

Package details

extension

Install @howaboua/pi-auto-trees from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@howaboua/pi-auto-trees
Package
@howaboua/pi-auto-trees
Version
0.1.11
Published
Jul 27, 2026
Downloads
1,505/mo · 437/wk
Author
howaboua
License
MIT
Types
extension
Size
21.8 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

@howaboua/pi-auto-trees

Adds three commands for carrying useful context through long Pi sessions without keeping every dead end and debugging turn.

Install

pi install npm:@howaboua/pi-auto-trees

Try it for one session:

pi -e npm:@howaboua/pi-auto-trees

Usage

  1. Run /prime <scope> to orient the agent on a repository area. When the agent fully settles, the extension marks the resulting conversation point automatically.
  2. Complete a coherent chunk of work.
  3. Run /end.

/prime defaults to the current repository when no scope is supplied. It can be repeated for different scopes; each completed priming turn gets its own marker.

/prime asks the agent for a concise orientation briefing and does not ask it to implement anything. The automatic marker is set only after Pi reports that the agent is fully settled, including any retry or compaction work.

/end summarizes the branch since the marker, navigates back to that point, carries the summary forward, and advances the marker to the new compact point. The summary keeps accepted changes, decisions, constraints, and relevant follow-up while dropping temporary implementation noise.

/end modes

  • /end — use the extension's completed-work summary guidance
  • /end git — also capture the commit that should be made
  • /end full — use Pi's normal branch-summary prompt
  • /end <guidance> — add a custom focus, for example /end focus on API changes and migration notes

The marker is stored in the session branch and restored when you return to it. Existing labels are preserved if the checkpoint already has one.

Configuration

On first load, the extension creates ~/.pi/agent/pi-auto-trees.json, or the equivalent path under $PI_CODING_AGENT_DIR.

{
  "summary": {
    "enabled": true,
    "model": "openai-codex/gpt-5.6-luna",
    "thinking": "low"
  }
}

/end uses the configured lightweight model for branch summaries. If that model or its credentials are unavailable, the extension reports the fallback and uses Pi's current session model.

Local development

bun install
bun run check
bun run pack:dry
pi -e ./index.ts