@xynogen/pix-prompts

Pi extension — system-prompt injection (SOP.md + repo directives)

Packages

Package details

extension

Install @xynogen/pix-prompts from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@xynogen/pix-prompts
Package
@xynogen/pix-prompts
Version
0.3.1
Published
Jul 16, 2026
Downloads
2,543/mo · 338/wk
Author
xynogen
License
MIT
Types
extension
Size
19.7 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "src/extension.ts"
  ]
}

Security note

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

README

pix-prompts

Pi extension — system-prompt injection (SOP.md + repo directives).

What it does

Injects structured context into the system prompt at the start of every agent turn via before_agent_start. Two sources are injected in order: the bundled SOP.md (the pix agent operating spec baseline), followed by repo-root directive files the Pi host does not load (GEMINI.md, .cursorrules, .windsurfrules). Each source is wrapped in a labelled XML tag for provenance.

Injection is idempotent and host-aware. A file is skipped when either our own tag is already present (retry turns) or the Pi host has injected that same absolute path as <project_instructions path="...">. Pi natively owns AGENTS.md and CLAUDE.md; pix-prompts intentionally does not scan them, preventing duplicate injection when host and extension paths use different normalization.

Install

pi install npm:@xynogen/pix-prompts

Also included in @xynogen/pix-core:

pi install npm:@xynogen/pix-core

Full distro

Source: github.com/xynogen/pix-mono

To install the complete pix suite (all packages + Pi itself):

curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh

License

MIT