pi-jj-auto

Automatic jj revision management for pi coding agent.

What it does

• 🛡️ Guards file edits — blocks write/edit when the current jj revision already has work
• 🏷️ Auto-describes — sets revision description from your prompt when work finishes on an empty revision
• 🤖 LLM decides — blocked edits show clear instructions, the model chooses jj new or jj desc

Install

pi install npm:pi-jj-auto

How it works

1. You send a prompt
2. LLM tries to edit a file
3. Extension checks the current jj revision:
   • Empty description → pass through (fresh revision)
   • Description + no diff → pass through (revision just created via jj new -m)
   • Description + diff → block with guidance: new task → jj new -m "...", same task → jj desc -m "..."
4. LLM runs the right jj command and retries the edit
5. When done, auto-describes the revision from your prompt if description is still empty

Configuration

Global: ~/.pi/agent/pi-jj-auto.json
Project: .pi/pi-jj-auto.json

{
  "enabled": true,
  "blockOnMismatch": true,
  "autoDescribe": true,
  "maxPromptLength": 72
}

Field	Type	Default	Description
enabled	boolean	true	Enable/disable
blockOnMismatch	boolean	true	Block edits or just notify
autoDescribe	boolean	true	Warn at turn end when revision has diff but no description
maxPromptLength	number	72	Max task length in guard messages

Debug

Run pi with debug logging to verify activation, skill injection, and bash classification:

PI_JJ_AUTO_DEBUG=1 pi