Pi Local Agents Only

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

Compatibility note: this package is currently tested against pi `0.80.1` as the suggested floor, and pi-bundled runtime packages are declared as optional wildcard peers. That keeps installs forward-open for future pi releases: npm peer ranges should not block users from trying a newer pi, though runtime behavior is only verified against the tested baseline until a follow-up package release confirms it.

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.