SikongJueluo 7e94452fe4 docs: add bilingual README
- add an English README and a Chinese translation with cross links,
  following the standard README.zh-CN.md convention
- cover packages, install prerequisites (authorizer chain), development
  workflow, and license
2026-09-16 21:36:09 +08:00
2026-08-08 18:14:37 +08:00
2026-09-16 21:36:09 +08:00
2026-09-16 21:36:09 +08:00

pi-extensions

English | 简体中文

Personal extensions for the pi coding agent, focused on Bash permissions: unwrap, inspect, and re-adjudicate commands before they run.

Packages

Package Description
pi-permission-ai-judge AI judge — a model rules allow / deny / defer on each pending Bash ask; shadow logs only, enforce auto-approves
pi-permission-inner-cmd Unwraps transparent Bash wrappers (timeout, time, …) and authorizes the inner command

Install

pi install git:github.com/SikongJueluo/pi-extensions

The package manifest (root package.json, pi.extensions) mounts both extensions declaratively — effective in any directory. Prerequisites:

  1. Enable @gotgenes/pi-permission-system ≥ 32
  2. Add the extensions to the authorizer chain — order is consultation order, UI sessions only:
// ~/.pi/agent/extensions/pi-permission-system/config.json
{ "authorizerChain": ["inner-cmd", "ai-bash-judge"] }

See the ai-judge README for modes, judge model, and guardrails.

Development

pnpm workspace, TypeScript + vitest.

pnpm install
pnpm check   # tsc --noEmit
pnpm test    # vitest run

Design decisions live in docs/adr/.

License

GPL-3.0

S
Description
No description provided
Readme GPL-3.0
496 KiB
Languages
TypeScript 97.7%
JavaScript 2.3%