---
type: reference
title: Pi Permission System
description: Permission enforcement and policy configuration system for pi-coding-agent extensions.
resource: https://github.com/gotgenes/pi-permission-system
tags:
  - pi
  - package
  - permissions
  - unverified
timestamp: 2026-08-28
---
[pi-permission-system](https://github.com/gotgenes/pi-permission-system) is the permission enforcement and policy configuration system for pi-coding-agent extensions.

---

## Documentation Index

| Document | File | Description |
|----------|------|-------------|
| Overview | README.md | Package overview, install, quick start, feature list |
| Configuration | configuration.md | Full policy reference, runtime knobs, per-agent overrides, common recipes |
| Session Approvals | session-approvals.md | Session-scoped rules, pattern suggestions, bash arity table |
| Cross-Extension API | cross-extension-api.md | Service accessor, event bus, decision/UI-prompt broadcasts |
| Subagent Integration | subagent-integration.md | Permission forwarding, coexistence with subagent extensions |
| Frontmatter Convention | permission-frontmatter-for-subagent-extensions.md | Convention guide for subagent extension authors |
| OpenCode Compatibility | opencode-compatibility.md | Shared concepts, divergences, porting guide |
| Troubleshooting | troubleshooting.md | Common issues, diagnostic logging, threat model |
| Migration: Legacy → Flat | legacy-to-flat.md | Migration from pre-v2 config layout |
| Migration: Strict Validation | strict-config-validation.md | Strict config validation (breaking) — reading and fixing rejected configs |

---

## Cross-References

- See [Skills](/skills/index.md) for the skill toolchain that replaced pi-package distribution.
- See [AGENTS.md Format](/core/agents-md-format.md) for the system-level instruction format that governs how this system is referenced in agent contracts.