@richardgill/pi-project-resources

Pi extension for loading project context files and skill directories inherited from ancestor directories.

Packages

Package details

extension

Install @richardgill/pi-project-resources from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@richardgill/pi-project-resources
Package
@richardgill/pi-project-resources
Version
0.1.1
Published
Aug 5, 2026
Downloads
94/mo · 6/wk
Author
richardgill
License
unknown
Types
extension
Size
7.3 KB
Dependencies
2 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

pi-project-resources

Pi extension for loading project context files and skill directories inherited from ancestor directories.

By default it loads these files while walking from the filesystem root to the current working directory:

  • AGENTS.local.md
  • CLAUDE.local.md

It also discovers these skill directories along the same path for trusted projects:

  • .pi/skills
  • .claude/skills

When context files are found, the extension shows them at startup and appends their contents to the system prompt. Existing skill directories are contributed through Pi's resources_discover event.

Part of pi-extensions.

Install with pi

pi install npm:@richardgill/pi-project-resources

or locally

pi install ~/code/pi-extensions/main/extensions/project-resources

Configure

You can override individual settings in project-resources.jsonc.

The default location is ~/.pi/agent/project-resources.jsonc, or $PI_EXTENSION_CONFIG_DIR/project-resources.jsonc when set.

{
  "contextFilenames": ["AGENTS.local.md", "CLAUDE.local.md"],
  "contextSectionTitle": "Extra Context Files",
  "skillDirectoryPaths": [".pi/skills", ".claude/skills"]
}