stack.json

{
  "name": "PUI",
  "description": "Opinionated batteries-included composition profile for vanilla Pi with a small update extension and Pi Web integration.",
  "platforms": [
    "windows",
    "macos",
    "linux"
  ],
  "upstream": {
    "agentRuntime": {
      "npm": "@earendil-works/pi-coding-agent",
      "version": "0.84.3",
      "repository": "https://github.com/earendil-works/pi"
    },
    "gui": {
      "npm": "@agegr/pi-web",
      "version": "0.8.11",
      "repository": "https://github.com/agegr/pi-web"
    },
    "subagents": {
      "npm": "@gotgenes/pi-subagents",
      "version": "19.3.5",
      "repository": "https://github.com/gotgenes/pi-packages"
    },
    "webAccess": {
      "npm": "pi-web-access",
      "version": "0.25.0",
      "repository": "https://github.com/nicobailon/pi-web-access"
    },
    "mcpAdapter": {
      "npm": "pi-mcp-adapter",
      "version": "2.29.0",
      "repository": "https://github.com/nicobailon/pi-mcp-adapter"
    },
    "browserAutomation": {
      "npm": "@playwright/mcp",
      "version": "0.0.79",
      "repository": "https://github.com/microsoft/playwright-mcp"
    },
    "goal": {
      "npm": "@narumitw/pi-goal",
      "version": "0.54.3",
      "repository": "https://github.com/narumiruna/pi-extensions/tree/main/packages/pi-goal"
    },
    "accounts": {
      "npm": "@narumitw/pi-accounts",
      "version": "0.49.11",
      "repository": "https://github.com/narumiruna/pi-extensions/tree/main/packages/pi-accounts"
    },
    "usage": {
      "npm": "@narumitw/pi-usage",
      "version": "0.52.3",
      "repository": "https://github.com/narumiruna/pi-extensions/tree/main/packages/pi-usage"
    },
    "askUserQuestion": {
      "npm": "@juicesharp/rpiv-ask-user-question",
      "version": "2.7.1",
      "repository": "https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-ask-user-question"
    },
    "fuzzyFileFinder": {
      "npm": "pi-fff",
      "version": "0.1.12",
      "repository": "https://github.com/ShpetimA/pi-fff"
    },
    "backgroundTasks": {
      "npm": "@99percentpeople/pi-background-tasks",
      "version": "2.1.1",
      "repository": "https://github.com/99percentpeople/pi-extensions/tree/master/extensions/background-tasks"
    }
  },
  "reasoningSummaryPatch": {
    "schemaVersion": 1,
    "revision": 15,
    "piWebPackage": "@agegr/pi-web",
    "piWebVersion": "0.8.11",
    "codingAgentPackage": "@earendil-works/pi-coding-agent",
    "codingAgentVersion": "0.84.3",
    "aiPackage": "@earendil-works/pi-ai",
    "aiVersion": "0.84.3",
    "backupSuffix": ".pui-reasoning-original",
    "manifest": ".pui-reasoning-summary.json"
  },
  "subagentsPromptPatch": {
    "schemaVersion": 1,
    "revision": 11,
    "packagePath": "node_modules/@gotgenes/pi-subagents",
    "files": [
      "src/tools/agent-tool.ts",
      "src/session/prompts.ts",
      "src/config/default-agents.ts",
      "src/config/agent-types.ts",
      "src/config/invocation-config.ts",
      "src/tools/spawn-config.ts",
      "src/runtime.ts",
      "src/types.ts",
      "src/observation/notification.ts",
      "src/index.ts",
      "src/settings.ts",
      "src/lifecycle/concurrency-limiter.ts",
      "src/lifecycle/subagent-manager.ts"
    ],
    "backupSuffix": ".pui-original",
    "manifest": ".pui-subagents-prompt-manifest.json"
  },
  "subagents": {
    "schemaVersion": 1,
    "maxConcurrent": 128,
    "maxQueued": 512,
    "modelMappings": {
      "openai-codex/gpt-5.6-sol": "openai-codex/gpt-5.6-luna"
    }
  },
  "backgroundTasksPromptPatch": {
    "schemaVersion": 1,
    "revision": 1,
    "packagePath": "node_modules/@99percentpeople/pi-background-tasks",
    "bundle": "index.min.js",
    "backupSuffix": ".pui-original",
    "manifestSuffix": ".pui-manifest.json"
  },
  "piPackages": [
    "npm:@gotgenes/pi-subagents@19.3.5",
    "npm:pi-web-access@0.25.0",
    "npm:pi-mcp-adapter@2.29.0",
    "npm:@narumitw/pi-goal@0.54.3",
    "npm:@narumitw/pi-accounts@0.49.11",
    "npm:@narumitw/pi-usage@0.52.3",
    "npm:@juicesharp/rpiv-ask-user-question@2.7.1",
    "npm:pi-fff@0.1.12",
    "npm:@99percentpeople/pi-background-tasks@2.1.1"
  ],
  "retiredPiPackages": [
    "npm:@sting8k/pi-vcc"
  ],
  "defaultTools": [
    "read",
    "bash",
    "edit",
    "write",
    "grep",
    "find",
    "ls"
  ],
  "piWeb": {
    "host": "127.0.0.1",
    "port": 30141,
    "url": "http://127.0.0.1:30141",
    "noOpenFlag": "--no-open"
  },
  "mcp": {
    "footerStatus": "off",
    "serverName": "playwright",
    "command": "npx",
    "args": [
      "-y",
      "@playwright/mcp@0.0.79",
      "--headless",
      "--browser",
      "chrome"
    ],
    "lifecycle": "lazy",
    "directTools": [
      "browser_navigate",
      "browser_snapshot",
      "browser_click",
      "browser_type",
      "browser_wait_for",
      "browser_take_screenshot"
    ]
  },
  "webAccess": {
    "configPath": "~/.pi/web-search.json",
    "searchRouting": {
      "providers": [
        "exa",
        "duckduckgo"
      ],
      "useCurrentModel": false,
      "fallbackOn": [
        "quota",
        "transient",
        "network",
        "invalid-response",
        "unsupported"
      ]
    },
    "fetchRouting": {
      "providers": [
        "http"
      ],
      "allowRemoteHostedProviders": false
    },
    "workflow": "none"
  },
  "askUserQuestion": {
    "configRelativePath": "rpiv-ask-user-question/config.json",
    "guidance": {
      "description": "Ask structured questions and wait for a response. Use when requested, or for a material choice genuinely owned by the user and unresolved by the request or available context. Decide delegated technical judgments and low-risk reversible details without asking. Free-text input is automatic; do not author \"Other\", \"Type something.\", or \"Next\" options. If recommending an option, list it first and append \"(Recommended)\". Use preview only for single-select visual comparisons.",
      "promptSnippet": "Ask structured questions when requested or for unresolved material user-owned choices",
      "promptGuidelines": [
        "When using ask_user_question, combine independent questions into one invocation, up to four questions per call; ask dependent questions only after earlier answers."
      ]
    }
  },
  "fff": {
    "enabledFeatures": [
      "autocomplete",
      "builtInReadEnhancement",
      "builtInGrepEnhancement"
    ],
    "retiredFeatures": [
      "agentTools"
    ]
  },
  "configPaths": {
    "piSettings": "~/.pi/agent/settings.json",
    "piAgentDir": "~/.pi/agent",
    "piWebAccess": "~/.pi/web-search.json",
    "mcpShared": "~/.config/mcp/mcp.json",
    "piFffFeatures": "~/.pi/agent/extensions/pi-fff.json",
    "piGoal": "~/.pi/agent/pi-goal.json",
    "askUserQuestion": "~/.config/rpiv-ask-user-question/config.json",
    "puiSubagents": "~/.config/pui/subagents.json"
  },
  "minimumNode": "22.19.0"
}