---
name: diffpi-setup
description: Set up or inspect the local @difflab/pi environment. Use when required tools, pi packages, skills, or MCP servers are missing.
allowed-tools: ask_user_question diffpi_reload diffpi_setup diffpi_validate
---

# diffpi Setup

Use `diffpi_validate` when the user asks only to inspect the environment.

Before `diffpi_setup`, use `ask_user_question` for choices the user has not already supplied. Include only unanswered questions from the template below. Do not ask these questions as plain chat text.

```typescript
ask_user_question({
  questions: [
    {
      question: 'Which issue tracker MCP server should diffpi configure?',
      header: 'Issue tracker',
      options: [
        { label: 'None', description: 'Do not configure Linear or Jira.' },
        { label: 'Linear', description: 'Configure the Linear MCP server with OAuth.' },
        { label: 'Jira', description: 'Configure the Atlassian MCP server with OAuth.' },
      ],
      multiSelect: false,
    },
    {
      question:
        'Allow diffpi to install mise, add its activation hook to your shell configuration, and install required development tools if they are missing?',
      header: 'Tooling',
      options: [
        {
          label: 'Allow',
          description: 'Install mise, Node.js, Zellij, Helix, and Context Mode when missing.',
        },
        {
          label: 'Skip',
          description: 'I will install and configure the required tooling myself.',
        },
      ],
      multiSelect: false,
    },
  ],
});
```

Map `None`, `Linear`, and `Jira` to `none`, `linear`, and `jira`. Infer the review forge from the current repository remote; do not ask about a single forge during ordinary setup. Only when the user explicitly asks to install hosted VCS MCP integrations, ask a multi-select question for GitHub and GitLab and pass the selected values as `forges`; zero selections means no VCS MCP installation. If the user selects `Skip` or declines the questionnaire, stop without calling `diffpi_setup`. After successful setup, call `diffpi_reload` when the setup result says pi must restart.

Do not configure Diffpi-managed Zed review keybindings; preserve manually owned editor configuration.

Setup installs Diffpi's bundled agent Markdown into Pi's standard global agent directory. The agents run through the subagent plugin; no inline profile selection is required for plan or review workflows.