pi-agents-local

Pi extension that loads AGENTS.local.md as private project instructions.

Package details

← Back
extension

Install pi-agents-local from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-agents-local
Package
pi-agents-local
Version
0.1.0
Published
May 2, 2026
Downloads
not available
Author
danieldisu
License
MIT
Types
extension
Size
4.8 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/agents-local.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-agents-local

Pi extension that loads AGENTS.local.md from the current working directory and appends it to the effective system prompt as private project instructions.

Install

Try without installing:

pi -e .

Install globally from a local checkout:

pi install .

Install project-locally:

pi install -l .

After publishing to git or npm:

pi install git:github.com/yourname/pi-agents-local@v0.1.0
pi install npm:pi-agents-local@0.1.0

Usage

Create AGENTS.local.md in the directory where you start Pi:

cat > AGENTS.local.md <<'EOF'
Private local instructions go here.
EOF

Keep it uncommitted:

echo "AGENTS.local.md" >> .git/info/exclude

The extension reads the file on each prompt, so edits are picked up without caching.

Command

Inside Pi:

/agents-local-status

Shows whether AGENTS.local.md exists, its path, byte size, modification time, and injection status.

Guardrails

  • Only reads AGENTS.local.md from ctx.cwd
  • Does not traverse parent directories
  • Does not accept arbitrary paths
  • Does not log or display file contents
  • Skips files larger than 50KB
  • Skips unreadable files and notifies once when UI is available

Test

npm test