pi-model-profiles

pi-model-profiles is a Pi extension for saving, updating, deleting, sorting, and applying whole-agent model frontmatter snapshots.

• Command: /model-profiles
• npm: https://www.npmjs.com/package/pi-model-profiles
• GitHub: https://github.com/MasuRii/pi-model-profiles

Features

• Save the current user/project agent model frontmatter as a reusable snapshot.
• Apply a saved snapshot across matching agent markdown files with atomic writes.
• Rename, update, remove, and sort saved snapshots from the interactive modal.
• Preserve profile data in profiles.json with schema-versioned migration support.
• Write optional debug logs only to the extension-local debug/ directory when enabled.

Installation

npm package

pi install npm:pi-model-profiles

Git repository

pi install git:github.com/MasuRii/pi-model-profiles

Local extension folder

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

| Scope | Path | |-------|------| | Global default | ~/.pi/agent/extensions/pi-model-profiles (respects PI_CODING_AGENT_DIR) | | Project | .pi/extensions/pi-model-profiles |

Pi discovers the extension through the root index.ts entry listed in package.json.

Usage

Run the command in interactive TUI mode:

/model-profiles

Modal shortcuts:

| Shortcut | Action | |----------|--------| | ↑ / ↓ | Move through snapshots | | Enter | Apply selected snapshot | | s | Save current agent state as a new snapshot | | r | Rename selected snapshot | | Ctrl+U | Update selected snapshot from current agent state | | Delete / Ctrl+D | Remove selected snapshot after confirmation | | Ctrl+S | Open sort menu | | Esc | Close modal, cancel input, or close sort menu |

Configuration

Runtime configuration lives in config.json at the extension root. The extension creates the file automatically with defaults on first load if it does not already exist.

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 defaults on first load.

{
  "debug": false,
  "profiles": {
    "autoSave": true,
    "maxProfiles": 100
  },
  "sorting": {
    "defaultSort": "date-desc"
  }
}

| Key | Type | Default | Purpose | |-----|------|---------|---------| | debug | boolean | false | Enables debug logging under debug/ directory | | profiles.autoSave | boolean | true | Reserved profile persistence setting | | profiles.maxProfiles | number | 100 | Reserved maximum profile retention setting | | sorting.defaultSort | name-asc \| name-desc \| date-asc \| date-desc | date-desc | Default snapshot sort order |

Profile Storage

Profile data is persisted in profiles.json at the extension root and should not be edited while Pi is running.

{
  "version": 2,
  "importedAt": "2026-04-26T00:00:00.000Z",
  "profiles": [
    {
      "id": "profile-id",
      "name": "Current agents snapshot",
      "createdAt": "2026-04-26T00:00:00.000Z",
      "updatedAt": "2026-04-26T00:00:00.000Z",
      "agents": [
        {
          "fileName": "code.md",
          "agentName": "code",
          "fields": {
            "model": "provider/model",
            "temperature": 0.2,
            "reasoningEffort": "medium"
          }
        }
      ]
    }
  ]
}

Debug Logging

Debug logging is controlled by the debug property in config.json.

• When debug is false or absent, no debug file handles are opened and no debug files are written.
• When debug is true, debug events are appended to debug/pi-model-profiles-debug.jsonl.
• Debug output is never written to console, stdout, or stderr.

Development

npm install
npm run build
npm run lint
npm run test
npm run check
npm run package:dry-run

Publishing

The package metadata follows the same publish-ready shape used by established 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, profiles.json, and debug/ logs excluded from npm publication

Related Pi Extensions

• pi-context-injector — Inject compact project context into first-turn and compaction prompts
• pi-agent-router — Active-agent routing and controlled subagent delegation
• pi-multi-auth — Multi-provider credential management, OAuth login, and account rotation
• pi-tool-display — Compact tool rendering and diff visualization

License

MIT