plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "piezas",
  "version": "0.6.2",
  "description": "Build, host and run business apps on Piezas from ChatGPT and Codex.",
  "author": {
    "name": "Piezas.ai",
    "url": "https://piezas.ai"
  },
  "homepage": "https://piezas.ai",
  "license": "MIT",
  "keywords": [
    "piezas",
    "business-apps",
    "app-hosting",
    "no-code"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Piezas",
        "shortDescription": "Build and host business apps",
        "longDescription": "Piezas lets you build, host and run business apps (bookings, CRMs, client portals, intake forms, internal tools) from ChatGPT and Codex.\n\nDescribe what your business needs in plain language. Piezas turns it into a short description you confirm, creates the app in your Piezas account, and gives it a home on Piezas hosting with sign-in, records, documents and email already built in. Your AI tool writes the parts unique to your business; Piezas runs the rest.\n\nWhat you can do with this plugin:\n- See which Piezas account you are signed in to, and list your apps.\n- Create a new app in your account.\n- Get an app key for your project (shown once, to keep on the server).\n- Learn the Piezas rules your app follows, so business records stay in Piezas and secrets never reach the browser.\n- In Codex desktop, publish a built app to its own address, after you confirm.\n\nIntended for business owners and teams building their own apps, with or without a developer.\n\nLimitations: building an app and putting it live need the app's files, so they happen in Codex desktop or the Piezas command line. In ChatGPT on the web, Piezas helps you plan the app, create it in your account and get its key. Deleting an app and changing team, billing or security settings are done by the owner in the Piezas console, not through this plugin. A Piezas account is required.",
        "developerName": "Piezas.ai",
        "category": "Developer Tools",
        "capabilities": [
          "Read",
          "Write"
        ],
        "defaultPrompt": [
          "Help me plan a booking app for my studio",
          "Which Piezas apps do I have?",
          "Create a Piezas app for client intake"
        ],
        "websiteURL": "https://piezas.ai",
        "supportURL": "https://help.apps.piezas.ai",
        "privacyPolicyURL": "https://piezas.ai/privacy",
        "termsOfServiceURL": "https://app.piezas.ai/terms",
        "logo": "./assets/icon.png",
        "composerIcon": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Shows the connected Piezas account",
              "prompt": "Which Piezas account am I connected to?",
              "tools_triggered": "piezas_whoami",
              "expected_behavior": "Reports the signed-in account's email, its organization name and the person's role, and says the connection covers every app the account can reach."
            },
            {
              "description": "Lists the account's apps",
              "prompt": "List my Piezas apps.",
              "tools_triggered": "piezas_list_apps",
              "expected_behavior": "Lists the review account's apps, each with its name and slug, and says how many are shown (for example \"Showing 3 of 3\")."
            },
            {
              "description": "Creates a new app",
              "prompt": "Create a Piezas app called Review Demo.",
              "tools_triggered": "piezas_create_app",
              "expected_behavior": "Confirms Review Demo was created and gives its future address, https://review-demo.apps.piezas.ai. If an app named Review Demo already exists in the account, says so, creates nothing and points to the existing app."
            },
            {
              "description": "Gets an app key for a project",
              "prompt": "Give me an API key for Review Demo.",
              "tools_triggered": "piezas_list_apps, piezas_create_api_key",
              "expected_behavior": "Finds Review Demo in the app list, then shows one new key, said to be shown only once, with the two lines PIEZAS_API_KEY and PIEZAS_API_URL to put in the project's .env, and says the key stays on the server and never goes in browser code."
            },
            {
              "description": "Explains where business records live",
              "prompt": "What are the Piezas rules for storing customer records?",
              "tools_triggered": "piezas_contract",
              "expected_behavior": "Explains that business records live in Piezas (its entity records service), not in local database tables inside the app, and that the app reaches them from its server with PIEZAS_API_KEY, which never goes in browser code."
            }
          ],
          "negative": [
            {
              "description": "Deleting an app is done by a person in the Piezas console; no tool here deletes anything",
              "prompt": "Delete my Review Demo app."
            },
            {
              "description": "Going live needs the app's files, which ChatGPT on the web does not have",
              "prompt": "Deploy my app now."
            },
            {
              "description": "Unrelated request",
              "prompt": "What is the weather in Vancouver today?"
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/105UTUR3a3HfQlA4mtyTbz8uCrGIsNKwh/view?usp=sharing"
      },
      "publication": {
        "release_notes": "Piezas now connects to your Piezas account through the hosted Piezas MCP server: see your account and apps, create apps, get app keys, read the Piezas rules, and (in Codex desktop) publish a built app after you confirm."
      },
      "apps": "./.app.json"
    }
  }
}