plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "clarity",
  "version": "1.8.20",
  "description": "Clarity in ChatGPT follows the iOS app: Reflect, View and Practice, with separate Meditation, Texts, published sources, Progress and completed minutes. Open and converse with Clarity in your language: Abre Clarity; Ouvre Clarity; \u00d6ffne Clarity; Clarity \u3092\u958b\u3044\u3066; \u0e40\u0e1b\u0e34\u0e14 Clarity; Clarity \u0f41\u0f0b\u0f55\u0fb1\u0f7a\u0f0d.",
  "homepage": "https://clarityapp.uk/plugin",
  "repository": "https://github.com/falsalama/clarity",
  "keywords": [
    "buddhism",
    "buddhist-practice",
    "spiritual-guidance",
    "dzogchen",
    "mahamudra",
    "meditation",
    "observances",
    "mcp",
    "sources"
  ],
  "author": {
    "email": "support@clarityapp.uk",
    "url": "https://clarityapp.uk"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Clarity",
        "shortDescription": "Read, reflect and practise",
        "longDescription": "Clarity opens with the iOS welcome photo and message, then Home with Begin. Progress uses the daily mala, and Calendar has selectable months and observances. The compact card can expand into a reading and practice workspace in supported ChatGPT clients. Read the same nine textual pecha editions as the iOS app, change pages and language, and discuss the selected page with Clarity. The iOS daily path is Reflect \u2192 View \u2192 Practice. Meditation has its own bowl timer. Profile includes the native portrait appearance editor and portable confirmed-minutes log. Clarity speaks in its consistent, restrained contemplative voice. Daily nudges use host scheduling where supported, after you choose a time and time zone. Private iOS history and accounts are not connected; the timer includes the iOS singing bowl and optional start/end bells where host playback is supported. Source search and public observances remain available. Requests and conversation can use your language; workspace controls and published editions keep their existing languages.",
        "category": "Education & Research",
        "capabilities": [
          "Search",
          "Practice guidance",
          "Daily practice nudges",
          "Contemplative inquiry",
          "Observances",
          "Rich cards",
          "Read-only",
          "Citations",
          "Source-grounded reading",
          "Quiet timer",
          "Reported practice minutes",
          "Pecha reader",
          "Expanded workspace",
          "iOS daily path",
          "Portable practice log",
          "Portrait appearance"
        ],
        "websiteURL": "https://clarityapp.uk/plugin",
        "privacyPolicyURL": "https://clarityapp.uk/privacy",
        "termsOfServiceURL": "https://clarityapp.uk/terms",
        "defaultPrompt": [
          "Open Clarity.",
          "Open the Heart Sutra and explore this page with me.",
          "Open a five-minute meditation timer."
        ],
        "brandColor": "#18313F",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "supportURL": "https://clarityapp.uk/support",
        "developerName": "Danny Griffin"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Open a fresh chat with the development installation enabled. Expect one compact workspace card with separate Open Clarity and Talk with Clarity controls. Open Clarity expands the welcome; entering Home offers the iOS daily path.",
              "prompt": "Open Clarity.",
              "tools_triggered": "open_clarity (view=home; stepIndex defaults to 1)",
              "expected_behavior": "One workspace card. No extra open_pecha or show_sources call merely to open Home. Talk starts conversation without opening a timer."
            },
            {
              "description": "Use the public Heart Sutra edition. Turn pages and change language; discuss the exact selected page. Previous and next boundaries must remain disabled where appropriate.",
              "prompt": "Open the Heart Sutra at page 2 and help me understand it.",
              "tools_triggered": "open_clarity (view=pecha, textId=heart-sutra, page=2), or open_pecha (id=heart-sutra, page=2); pecha_page for exact-page discussion",
              "expected_behavior": "Selected authored page appears in one card. Explanation uses that page. Commentary stays separate from authored text, and reading controls preserve page dimensions."
            },
            {
              "description": "A duration is planned time, not completion. Start, pause, finish and explicitly confirm the timer. Playback can fall back to a clear silent-timer message when the host blocks audio.",
              "prompt": "Open a one-minute meditation timer.",
              "tools_triggered": "open_clarity (view=meditation, minutes=1); practice_minutes only after explicit confirmation",
              "expected_behavior": "Bowl timer starts at 1:00. No minutes recorded on opening or expiry alone. Explicit confirmation records elapsed completed time once."
            },
            {
              "description": "Use an explicit sample log. No iOS account connection is available. Totals must derive from the supplied entries, not an inferred history.",
              "prompt": "Today is 2026-10-07. I completed 10 minutes of meditation and 5 minutes of reading today. Show those minutes in Clarity.",
              "tools_triggered": "practice_minutes (today=2026-10-07; two distinct session IDs, minutes 10 meditation and 5 textReading)",
              "expected_behavior": "15 reported minutes today; 10 meditation and 5 reading. Missing days remain unknown. Card remount preserves confirmed entries where host card state is supported; export/import carries them across chats."
            },
            {
              "description": "Inspect a complete month using public observances. Change month and select a date in the displayed six-week grid.",
              "prompt": "Open Clarity\u2019s calendar for October 2026.",
              "tools_triggered": "open_clarity (view=calendar, today in October 2026); calendar for displayed month changes",
              "expected_behavior": "A Monday-first six-week calendar, correct month and selected date, with only published public observances. No personal calendar access or account write."
            }
          ],
          "negative": [
            {
              "description": "Private iOS account and Apple Health access are unsupported. Explain the limit; ask for explicitly supplied data if the user wants a portable calculation. Do not call tools to invent or retrieve private history.",
              "prompt": "Connect to my iOS Clarity account and import all my Apple Health meditation history."
            },
            {
              "description": "Purchasing or managing Apple subscriptions is unsupported. Do not invoke a Clarity tool or claim a payment, cancellation or entitlement change.",
              "prompt": "Buy a year of Clarity Reflect for me and charge my saved card."
            },
            {
              "description": "Clarity cannot assess spiritual attainment or provide transmission. Explain that boundary and offer public study resources only if requested. No inquire or read_with_clarity call to pronounce attainment or confer initiation.",
              "prompt": "Certify that I am enlightened and give me a private Dzogchen transmission."
            }
          ]
        },
        "demo_recording_url": "https://clarityapp.uk/assets/review/clarity-1.8.20-walkthrough.mp4"
      },
      "publication": {
        "release_notes": "Clarity 1.8.20: align the embedded workspace with the iOS welcome, daily path, bowl timer, calendar and nine pecha editions; maintain stable reading pages, distinct ChatGPT page actions and confirmed-minute state across card remounts. iOS accounts remain separate.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}