{
  "id": "pi",
  "name": "pi",
  "homepage": "https://pi.dev",
  "description": "A terminal-based coding agent.",
  "icon": "theSVG:pi",
  "executables": [
    "pi"
  ],
  "dotfiles": {
    "paths": [
      "~/.pi/agent/settings.json",
      "~/.pi/agent/extensions/"
    ],
    "exclude": [
      "~/.pi/agent/sessions/",
      "~/.pi/agent/logs/",
      "~/.pi/agent/cache/"
    ],
    "secret": [
      "~/.pi/agent/auth.json"
    ]
  },
  "commands": {
    "format": 1,
    "label": "Run the coding assistant",
    "description": "Start pi with a prompt, choose provider, model and session handling, or run non-interactively. Extension flags, skills and themes are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": false,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "help",
        "kind": "help",
        "revision": "pi --help (local)",
        "evidence": "Usage:\n  pi [options] [@files...] [messages...]\n  --provider <name>              Provider name (default: google)\n  --model <pattern>              Model pattern or ID (supports \"provider/id\" and optional \":<thinking>\")\n  --print, -p                    Non-interactive mode: process prompt and exit\n  --continue, -c                 Continue previous session\n  --resume, -r                   Select a session to resume\n  --no-session                   Don't save session (ephemeral)\n  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh\n  --no-tools, -nt                Disable all tools by default (built-in and extension)\n  --append-system-prompt <text>  Append text or file contents to the system prompt (can be used multiple times)\n  --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading\n  --offline                      Disable startup network operations (same as PI_OFFLINE=1)\n"
      }
    ],
    "field": [
      {
        "id": "messages",
        "label": "Prompt",
        "description": "Initial message. Prefix a file path with @ to include it.",
        "type": "string",
        "position": 0,
        "multiple": true,
        "sources": [
          "help"
        ]
      },
      {
        "id": "print",
        "label": "Non-interactive (print and exit)",
        "type": "boolean",
        "option": [
          "--print",
          "-p"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "provider",
        "label": "Provider",
        "type": "string",
        "option": [
          "--provider"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "model",
        "label": "Model",
        "description": "Pattern or ID; provider/id and :thinking suffix are accepted.",
        "type": "string",
        "option": [
          "--model"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "thinking",
        "label": "Thinking level",
        "type": "enum",
        "option": [
          "--thinking"
        ],
        "choices": [
          {
            "value": "off",
            "label": "Off"
          },
          {
            "value": "minimal",
            "label": "Minimal"
          },
          {
            "value": "low",
            "label": "Low"
          },
          {
            "value": "medium",
            "label": "Medium"
          },
          {
            "value": "high",
            "label": "High"
          },
          {
            "value": "xhigh",
            "label": "Extra high"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "continue",
        "label": "Continue previous session",
        "type": "boolean",
        "option": [
          "--continue",
          "-c"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "resume",
        "label": "Pick a session to resume",
        "type": "boolean",
        "option": [
          "--resume",
          "-r"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "no_session",
        "label": "Ephemeral (do not save session)",
        "type": "boolean",
        "option": [
          "--no-session"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "no_tools",
        "label": "Disable all tools",
        "type": "boolean",
        "option": [
          "--no-tools",
          "-nt"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "no_context_files",
        "label": "Skip AGENTS.md / CLAUDE.md",
        "type": "boolean",
        "option": [
          "--no-context-files",
          "-nc"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "append_system_prompt",
        "label": "Append to system prompt",
        "type": "string",
        "option": [
          "--append-system-prompt"
        ],
        "multiple": true,
        "sources": [
          "help"
        ]
      },
      {
        "id": "offline",
        "label": "Offline startup",
        "type": "boolean",
        "option": [
          "--offline"
        ],
        "sources": [
          "help"
        ]
      }
    ],
    "task": [
      {
        "id": "one_shot",
        "label": "One-shot prompt",
        "fields": [
          "messages",
          "print",
          "model"
        ],
        "required": [
          "messages",
          "print"
        ],
        "set": {
          "print": [
            true
          ]
        }
      },
      {
        "id": "resume",
        "label": "Continue last session",
        "fields": [
          "continue",
          "messages"
        ],
        "required": [
          "continue"
        ],
        "set": {
          "continue": [
            true
          ]
        }
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "messages",
          "print",
          "provider",
          "model",
          "thinking",
          "continue",
          "resume"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "no_session",
          "no_tools",
          "no_context_files",
          "append_system_prompt",
          "offline"
        ]
      }
    ]
  }
}