pi-context-injector

pi-context-injector is a Pi extension that injects compact project context into the first user turn and adds continuity context after conversation compaction.

• npm: https://www.npmjs.com/package/pi-context-injector
• GitHub: https://github.com/MasuRii/pi-context-injector

Capabilities

• Adds README excerpts, recent git history, workspace state, and detected tech stack context before the first model response.
• Supports model-aware XML or Markdown formatting for injected context blocks.
• Adds optional compaction continuity context containing workspace state, recent files, todo state, and configured additional context.
• Provides the /context-injector TUI command for configuration inspection, path display, reset, and interactive settings.
• Keeps debug logging disabled by default and writes only to the extension-local debug/ directory when enabled.

Installation

npm package

pi install npm:pi-context-injector

Git repository

pi install git:github.com/MasuRii/pi-context-injector

Local extension folder

Place this folder in one of Pi's extension discovery paths:

| Scope | Path | |-------|------| | Global default | ~/.pi/agent/extensions/pi-context-injector | | Project | .pi/extensions/pi-context-injector |

Pi discovers the extension through the root index.ts entry listed in package.json, which forwards to src/index.ts.

Usage

Open the interactive TUI settings modal with:

/context-injector

Useful command forms:

/context-injector show
/context-injector path
/context-injector reset

Configuration

Runtime configuration is stored at the extension root:

~/.pi/agent/extensions/pi-context-injector/config.json

A starter template is included at config/config.example.json. Copy it to config.json for local customization, or let the extension create config.json with production defaults on first load.

cp config/config.example.json config.json

The published package intentionally excludes local runtime state: config.json and debug/ stay local to each installation.

Configuration options

| Key | Type | Default | Purpose | |-----|------|---------|---------| | debug | boolean | false | Enables debug logging under debug/pi-context-injector-debug.log | | enabled | boolean | true | Enables first-turn and compaction context injection | | silent | boolean | true | Hides injected context from the chat UI while still sending it to the model | | injectionTarget | "user_message" \| "system_prompt" | "user_message" | Selects where initial project context is injected | | dynamicFormat | boolean | true | Selects XML or Markdown formatting based on the model family | | readmeLines | number | 50 | Limits README lines before pruning | | commitCount | number | 5 | Limits recent commits included in first-turn context | | enableReadme | boolean | true | Includes README context when a README file is available | | enableGit | boolean | true | Includes recent commit context from Git repositories | | enableWorkspaceState | boolean | true | Includes concise workspace status context | | enableTechStack | boolean | true | Includes detected dependency and project metadata context | | maxDependencies | number | 15 | Limits dependency names included in tech-stack context | | smartPrune | boolean | true | Removes low-signal README content before injection | | skipForkedSessions | boolean | true | Avoids duplicate initial injection in parent-linked sessions | | compaction.enabled | boolean | true | Enables post-compaction continuity context | | compaction.maxRecentFiles | number | 20 | Limits recent files included in compaction continuity context | | compaction.recentFilesMaxAge | number | 7 | Limits recent files to this age in days | | compaction.additionalContext | string[] | [] | Adds operator-provided continuity notes after compaction |

Example config

{
  "enabled": true,
  "silent": true,
  "injectionTarget": "user_message",
  "dynamicFormat": true,
  "readmeLines": 50,
  "commitCount": 5,
  "enableReadme": true,
  "enableGit": true,
  "enableWorkspaceState": true,
  "enableTechStack": true,
  "maxDependencies": 15,
  "smartPrune": true,
  "stripBold": true,
  "pruneLicense": true,
  "stripHtmlComments": true,
  "maxCodeBlockLines": 15,
  "stripNavigationLinks": true,
  "stripDetailsTags": true,
  "ignoredSections": [
    "Sponsors",
    "Contributors",
    "Backers",
    "Acknowledgements",
    "Changelog",
    "Donate"
  ],
  "skipForkedSessions": true,
  "debug": false,
  "compaction": {
    "enabled": true,
    "injectWorkspaceState": true,
    "injectTechStack": false,
    "injectActiveFiles": true,
    "injectTodoState": true,
    "maxRecentFiles": 20,
    "recentFilesMaxAge": 7,
    "additionalContext": []
  }
}

Invalid or missing values are normalized to bounded defaults when the extension loads configuration.

Debug logging

Debug logging is disabled by default through "debug": false. When enabled, logs are appended only to:

debug/pi-context-injector-debug.log

The extension does not write debug output to console, stdout, or stderr, and no debug log file is opened when debug logging is disabled.

Repository structure

This package follows the same published-extension shape used by local Pi extensions such as pi-agent-router and pi-multi-auth: the stable Pi discovery entrypoint remains at the repository root, and implementation modules live under src/.

pi-context-injector/
├── index.ts                         # Stable Pi extension entrypoint for auto-discovery
├── src/
│   ├── index.ts                     # Extension bootstrap and hook registration
│   ├── command-runner.ts            # Bounded external command execution helpers
│   ├── config-modal.ts              # `/context-injector` command and TUI settings modal
│   ├── config-store.ts              # Config creation, loading, validation, and saving
│   ├── constants.ts                 # Runtime paths, defaults, and message type constants
│   ├── context-builder.ts           # Project and compaction context assembly
│   ├── jsonc.ts                     # JSONC parsing helper for legacy config migration
│   ├── logger.ts                    # File-only debug logger gated by config.json
│   └── types.ts                     # Shared extension types
├── config/
│   └── config.example.json          # Starter config template
├── CHANGELOG.md
├── LICENSE
├── package.json
├── README.md
└── tsconfig.json

Development

npm install
npm run build
npm run lint
npm run test
npm run check
npm pack --dry-run

All verification scripts type-check the strict TypeScript project. The package is configured for public npm publication through publishConfig.access: "public".

Publishing

The package metadata follows the publish-ready shape used by established local Pi extensions:

• entrypoint: index.ts
• package exports: . → ./index.ts
• Pi extension manifest: pi.extensions
• published files: source, README, changelog, license, and config template
• runtime config.json and debug/ logs excluded from npm publication

Related Pi Extensions

| Extension | Install | Description | |-----------|---------|-------------| | pi-agent-router | pi install npm:pi-agent-router | Active-agent routing and controlled subagent delegation that can require context injection for delegated sessions | | pi-multi-auth | pi install npm:pi-multi-auth | Multi-provider credential management, OAuth login, and account rotation | | pi-mcp-adapter | pi install git:github.com/MasuRii/pi-mcp-adapter | MCP server discovery and Pi tool exposure for external context sources | | pi-rtk-optimizer | pi install npm:pi-rtk-optimizer | RTK command rewriting and tool output compaction that complements compact context injection |

License

MIT