pi-sync-instructions1.0.0
Pi extension that compiles a folder of agent instructions (INDEX.md + linked files) into Pi's AGENTS.md on startup.
Untested on omp
This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.
Reports 0
No reports yet.
Readme
pi-sync-instructions
A Pi extension that compiles a folder of agent instructions into Pi's AGENTS.md on every session start.
The folder must contain an INDEX.md that links to instruction files as ./name.md. Each linked file that exists is appended to <agent dir>/AGENTS.md (default ~/.pi/agent/AGENTS.md).
Install
pi install npm:pi-sync-instructions
Configure the instructions folder
Default: ~/.agents/instructions. Precedence, highest first:
- CLI flag:
pi --instructions-dir ~/my/instructions - Env var:
PI_SYNC_INSTRUCTIONS_DIR=~/my/instructions - Config file
~/.pi/agent/sync-instructions.json(honoursPI_CODING_AGENT_DIR):{ "instructionsDir": "~/my/instructions", "outputFile": "~/.pi/agent/AGENTS.md", "logFile": "~/.pi/instructions-sync.log" } ~/.agents/instructions
~ is expanded; relative paths resolve from the current directory. outputFile and logFile are optional.
Usage
- Sync runs automatically on
session_start. Errors show as notifications. - Run
/sync-instructionsto re-sync without restarting. - Sync history is appended to the log file.
Development
npm test
pi -e ./ # try locally
License
MIT