@yevhen.b/pi-preflight
Tool-call approvals and policy rules for Pi.
Package details
Install @yevhen.b/pi-preflight from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@yevhen.b/pi-preflight- Package
@yevhen.b/pi-preflight- Version
0.0.9- Published
- Mar 13, 2026
- Downloads
- 14/mo · 4/wk
- Author
- yevhen.bobrov
- License
- MIT
- Types
- extension
- Size
- 138.4 KB
- Dependencies
- 1 dependency · 3 peers
Pi manifest JSON
{
"extensions": [
"index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
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-preflight
From a local checkout:
pi install /absolute/path/to/bo-pi/preflight
Temporary run without installing:
pi -e npm:@yevhen.b/pi-preflight
Commands
/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