@foxfirecodes/pi-agents-local-md

Pi extension that autoloads AGENTS.local.md alongside AGENTS.md context files.

Packages

Package details

extension

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

$ pi install npm:@foxfirecodes/pi-agents-local-md
Package
@foxfirecodes/pi-agents-local-md
Version
0.1.4
Published
May 27, 2026
Downloads
not available
Author
foxfirecodes
License
MIT
Types
extension
Size
7.9 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/agents-local-md.js"
  ]
}

Security note

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

README

pi-agents-local-md

Pi package that autoloads AGENTS.local.md files as additional context.

Behavior

On each agent turn, the extension discovers AGENTS.local.md from:

  1. ~/.pi/agent/AGENTS.local.md (or $PI_CODING_AGENT_DIR/AGENTS.local.md)
  2. Parent directories, walking from filesystem root down to the current working directory
  3. The current working directory

Discovered files are appended to the system prompt in that order, so more specific files appear later. If pi ever natively loads AGENTS.local.md, this extension skips paths that pi already reports as loaded context files.

The extension respects --no-context-files / -nc and does not inject local context when those flags are present.

Install

pi install npm:@foxfirecodes/pi-agents-local-md

Development

From this checkout:

pi install .

Or try it for one run:

pi -e /path/to/pi-extensions/packages/pi-agents-local-md

To run automated tests:

pnpm test