@d3ara1n/context-include

@path syntax for AGENTS.md — include files by reference with recursive resolution

Packages

Package details

extension

Install @d3ara1n/context-include from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@d3ara1n/context-include
Package
@d3ara1n/context-include
Version
1.0.0
Published
May 30, 2026
Downloads
not available
Author
d3ara1n
License
MIT
Types
extension
Size
6.8 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./context-include.ts"
  ]
}

Security note

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

README

@d3ara1n/context-include

@path syntax for AGENTS.md — include files by reference.

Features

  • Relative paths: @CODEGRAPH.md, @./docs/rules.md, @../shared/AGENTS.md
  • Absolute paths: @/absolute/path/to/file.md
  • Home directory: @~/.agents/CODEGRAPH.md
  • Recursive includes: included files can themselves contain @ references
  • Cycle detection: prevents infinite include loops
  • Size guard: 500KB total limit, 10 levels deep

Install

pi install npm:@d3ara1n/context-include

Usage

In any AGENTS.md file:

# Project Rules

@./docs/api-conventions.md
@~/.agents/CODEGRAPH.md

On each turn, the extension reads the referenced files and injects their content into the system prompt.

Supported file types

.md, .txt, .yaml, .yml, .json, .toml