pi-jj-auto

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# pi-jj-auto

Automatic [jj](https://github.com/martinvonz/jj) revision management for [pi](https://pi.dev) 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

```bash
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`

```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:

```bash
PI_JJ_AUTO_DEBUG=1 pi
```

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

You send a prompt
LLM tries to edit a file
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 "..."
LLM runs the right jj command and retries the edit
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