avtc-pi-parallel-work-guardrail
Lets you block or approve agent-called git operations that would disrupt parallel work — worktree-aware, with auto-decide after timeout.
Package details
Install avtc-pi-parallel-work-guardrail from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:avtc-pi-parallel-work-guardrail- Package
avtc-pi-parallel-work-guardrail- Version
1.0.5- Published
- Jul 17, 2026
- Downloads
- 882/mo · 882/wk
- Author
- avtc
- License
- MIT
- Types
- extension
- Size
- 67.9 KB
- Dependencies
- 3 dependencies · 0 peers
Pi manifest JSON
{
"extensions": [
"./index.ts",
"../avtc-pi-ui-components/index.ts"
],
"allowedCodeDeps": [
"avtc-pi-logger",
"avtc-pi-settings-ui",
"avtc-pi-ui-components"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
avtc-pi-parallel-work-guardrail
Lets you block or approve agent-called git operations that would disrupt parallel work — worktree-aware, with auto-decide after timeout.
Features
- 10 disruptive categories — stash, checkout/restore, branch-switch, destructive reset, rebase, amend, merge/pull, push, redirect workarounds, and plumbing restore
- 5 modes, including hands-off auto-decide — off, ask (prompt), block, or ask with auto-allow / auto-block after 15 min of no response
- Worktree-aware — 6 categories are allowed without a prompt inside a git worktree, since worktree-scoped ops don't collide with the main branch
- Bypass-resistant — disruptive ops can't slip past it via
git -C,--git-dir,--work-tree, or by being buried in&&,||,;, pipes, or subshells - Confirmation dialog — confirmable operations are routed through a prompt before they run
The confirmation dialog for a disruptive operation (routed via showSelectWithNote, auto-resolves to Block on timeout):
Categories
| Category | Blocked commands | Relaxed in worktree? |
|---|---|---|
| Stash | git stash, stash push, stash pop, stash drop, stash clear, stash branch |
No |
| Checkout/restore | git checkout --, git restore |
Yes |
| Branch switch | git checkout, git switch (all variants) |
Yes |
| Destructive reset | git reset --hard, reset --mixed <ref>, bare reset <ref> |
No |
| Rebase | git rebase, git pull --rebase (excludes --abort/--continue/--skip) |
No |
| Amend | git commit --amend |
Yes |
| Merge | git merge, git pull (non-rebase) |
Yes |
| Push | git push |
No |
| Redirect workaround | git show ... > file, git cat-file ... > file |
Yes |
| Plumbing restore | git checkout-index, git read-tree --reset -u |
Yes |
Commands
| Command | Description |
|---|---|
/parallel-work-guardrail:settings |
Open the settings UI (guardrail mode selection) |
Configuration
Settings are stored in ~/.pi/agent/avtc-pi-parallel-work-guardrail-settings.json (global) or <cwd>/.pi/avtc-pi-parallel-work-guardrail-settings.json (project overrides win) and edited via /parallel-work-guardrail:settings. Requires avtc-pi-settings-ui and avtc-pi-ui-components (installed automatically as dependencies).
| Key | Type | Default | Description |
|---|---|---|---|
parallelWorkGuardrail |
string | "ask" |
Guardrail mode: "off" (skip all checks), "ask" (prompt user, waits indefinitely), "block" (auto-block every disruptive command), "ask-allow-15m" (prompt + auto-allow after 15m of no response), "ask-block-15m" (prompt + auto-block after 15m) |
Installation
pi install npm:avtc-pi-parallel-work-guardrail
Full suite
Check out the full suite of related extensions, avtc-pi — deterministic feature development, subagent delegation, working-memory, behavioral learning, parallel-work guardrails, durable decisions, notifications, and more.
Developed with Z.ai — get 10% off your subscription via this referral link.
License
MIT