pi-engineer replaces Pi's default root system prompt with a portable software-engineering policy.
Inspired by the behavioral principles of mature coding agents like Codex, it brings disciplined engineering judgment to Pi around scope, workspace protection, verification, and safety while keeping your tools, project context, Skills, and additive instructions intact.
- Scope & authorization: Inspects and reports for read-only requests without modifying files. For implementation requests, modifies only relevant code and verifies changes autonomously.
- Ambiguity & judgment: Resolves minor local details autonomously, but asks before making consequential architectural or scope choices.
- Workspace protection: Respects existing and uncommitted changes. Avoids unsolicited refactoring, cleanup, or destructive commands like
git reset --hard. - Destructive safety: Refuses recursive deletion of protected roots (such as repository roots or home directories), even if explicitly requested.
- Progressive Skill usage: Discovers available Agent Skills and loads their instructions only when needed.
- Ecosystem preservation: Seamlessly preserves your tools, project instructions (
AGENTS.md), custom additions (APPEND_SYSTEM.md), and working directory.
pi install npm:@hudrazine/pi-engineer
Or install directly from GitHub:
pi install git:github.com/hudrazine/pi-engineer
Once installed, pi-engineer automatically replaces Pi's root prompt for eligible agent sessions.
Inspect status at any time:
/pi-engineer status
This reports whether prompt replacement is active, why it is inactive (if applicable), and the installed Package and Portable Core versions.
Disable pi-engineer without uninstalling it with pi config:
- Globally: run
pi configand toggle off the extension of@hudrazine/pi-engineer. - Project only: run
pi config -linstead to edit.pi/settings.json.
Toggle it back on the same way. Changes take effect the next time Pi starts; while disabled, /pi-engineer status is unavailable too.
- Additive instructions:
APPEND_SYSTEM.md, project instructions (AGENTS.md), and Skills are preserved and appended as usual. - Explicit root prompts: If a custom root prompt is set (via
SYSTEM.md,--system-prompt, or a custom template),pi-engineersteps aside and disables itself for that run, notifying you once in interactive sessions.
- A recent Pi release is recommended. Older releases are not tested or guaranteed.
- Built entirely on Pi's public Extension APIs and prompt helpers.
- If another extension directly rewrites the system prompt, extension execution order determines the final result.
- The policy is model-agnostic; individual models may still show slight probabilistic variations in edge cases.
MIT