pi-local-agents-only

Pi extension that strips global AGENTS.md and CLAUDE.md from the effective prompt for selected projects.

Package details

extension

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

$ pi install npm:pi-local-agents-only
Package
pi-local-agents-only
Version
0.1.13
Published
May 2, 2026
Downloads
1,136/mo · 162/wk
Author
fitchmultz
License
MIT
Types
extension
Size
25.3 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

pi-local-agents-only

Use repo-local AGENTS.md only for selected projects by stripping global AGENTS.md and CLAUDE.md from pi's effective prompt.

Install

Install it from npm with pi:

pi install npm:pi-local-agents-only

Or install it directly from GitHub with pi:

pi install https://github.com/fitchmultz/pi-local-agents-only

Use

Enable for the current repo:

/local-agents-only on

Disable for the current repo:

/local-agents-only off

/local-agents-only off clears the repo marker only. If the repo is still enabled via /local-agents-only global-on or PI_LOCAL_AGENTS_ONLY=1, it remains enabled until you also run /local-agents-only global-off or unset the env var.

Enable or disable via the global allowlist:

/local-agents-only global-on
/local-agents-only global-off

Check status:

/local-agents-only status

Repo opt-in uses this marker file:

.pi/local-agents-only

For git repos, marker and global allowlist activation apply across linked worktrees.

Env override for one run:

PI_LOCAL_AGENTS_ONLY=1 pi
PI_LOCAL_AGENTS_ONLY=0 pi

This changes the prompt the model sees. It does not change pi's startup header.

If you toggle it during an existing session, start a fresh turn or /new for the cleanest verification.