https://github.com/fitchmultz/pi-local-agents-only
Pi extension that strips global AGENTS.md and CLAUDE.md from the effective prompt for selected projects.
https://github.com/fitchmultz/pi-local-agents-only
agents-md claude-md npm-package pi pi-extension pi-package prompt-context typescript
Last synced: 11 days ago
JSON representation
Pi extension that strips global AGENTS.md and CLAUDE.md from the effective prompt for selected projects.
- Host: GitHub
- URL: https://github.com/fitchmultz/pi-local-agents-only
- Owner: fitchmultz
- License: mit
- Created: 2026-03-26T15:17:35.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-23T19:54:34.000Z (17 days ago)
- Last Synced: 2026-05-23T21:24:07.501Z (17 days ago)
- Topics: agents-md, claude-md, npm-package, pi, pi-extension, pi-package, prompt-context, typescript
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/pi-local-agents-only
- Size: 366 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
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:
```bash
pi install npm:pi-local-agents-only
```
Or install it directly from GitHub with pi:
```bash
pi install https://github.com/fitchmultz/pi-local-agents-only
```
Compatibility note: this package is tested against the current pi release during each package update, 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:
```bash
/local-agents-only on
```
Disable for the current repo:
```bash
/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:
```bash
/local-agents-only global-on
/local-agents-only global-off
```
Check status:
```bash
/local-agents-only status
```
Repo opt-in uses this marker file:
```text
.pi/local-agents-only
```
For git repos, marker and global allowlist activation apply across linked worktrees.
Env override for one run:
```bash
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.