@yevhen.b/pi-preflight
v0.0.9
Published
Tool-call approvals and policy rules for Pi.
Maintainers
Readme
Preflight
Preflight adds a tool approval layer to Pi.
It summarizes each tool call, marks destructive actions, applies deterministic and natural-language policy rules, and asks for approval when needed.
Install
Install from npm:
pi install npm:@yevhen.b/pi-preflightFrom a local checkout:
pi install /absolute/path/to/bo-pi/preflightTemporary run without installing:
pi -e npm:@yevhen.b/pi-preflightCommands
/preflightopens the interactive settings menu./preflight statusprints active settings./preflight approvals all|destructive|offsets approval mode./preflight context full|<N>sets context for explain and rule suggestions./preflight model current|provider/modelsets the preflight model./preflight policy-model current|provider/modelsets the policy/rule-suggestion model./preflight debug on|offtoggles debug logs./preflight reset-sessionclears session overrides.
Highlights
- Human-readable summaries for tool calls before you approve them.
- Three approval modes: ask for everything, only destructive actions, or turn approvals off.
- Deterministic permissions plus plain-language policy rules.
- Inline rule authoring with suggested rules and conflict warnings.
- Explain mode for a deeper description and risk assessment.
- Separate models for preflight classification and policy evaluation.
Config files
- Persistent settings:
~/.pi/agent/extensions/bo-pi/preflight.json - Workspace rules:
.pi/preflight/settings.local.json - Global rules:
~/.pi/preflight/settings.json - Debug log:
.pi/preflight/logs/preflight-debug.log
