plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "brewmark",
  "version": "1.2.3",
  "description": "Grind settings for 200+ home coffee grinders, conversion of a setting from one grinder to another, and help choosing a grinder to buy.",
  "author": {
    "name": "BrewMark",
    "url": "https://brewmark.io",
    "email": "jeff@jeffreygluck.com"
  },
  "homepage": "https://brewmark.io",
  "keywords": [
    "coffee",
    "grinder",
    "grind size",
    "espresso",
    "pour over"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "BrewMark",
        "shortDescription": "Coffee grinder settings",
        "longDescription": "BrewMark is a home coffee brewing tool. It gives the grind setting to use on your own coffee grinder, for every brew method from espresso to cold brew. It covers 200+ home grinders, including Baratza, Fellow, Comandante, 1Zpresso, Timemore, Niche and DF64.\n\nAsk things like:\n- \"What setting should I use for pour over on my Fellow Ode Gen 2?\"\n- \"The recipe says 18 clicks on a Comandante C40 MK4. What's that on my Baratza Encore?\"\n- \"Which grinder should I get for pour over under $200?\"\n\nAnswers come as a card: the setting drawn on your grinder's dial, every brew method on one chart with a starting recipe, and \"too sour\" / \"too bitter\" buttons that move the dial a step at a time. Tell it how the cup tasted and it gives the next setting to try; say it's dialed in and the assistant can remember it for that coffee. Shopping for a grinder, you get a shortlist with photos, approximate prices and a link to each one's BrewMark buying guide.\n\nBrewMark maps every grinder onto one shared 0 to 100 grind scale, so a setting quoted for one grinder can be translated to another.\n\nIntended for home brewers dialing in a grinder they own, following a recipe written for a different one, or deciding which grinder to buy.\n\nLimitations: settings are starting points, not guarantees. Burr wear, bean density and roast level shift the right setting, so expect to adjust by taste. BrewMark does not give settings for grinders where its data is not good enough to publish (for example the Kafatek Monolith), and says so rather than guessing. Prices are approximate US list prices. It does not sell anything or need an account. When you report how a cup tasted, BrewMark keeps an anonymous record (grinder, brew method, setting, taste, and the coffee's name if given; no IP address or identifier) to improve starting settings for particular coffees.",
        "developerName": "BrewMark",
        "category": "Other",
        "websiteURL": "https://brewmark.io/grinders",
        "supportURL": "https://brewmark.io/contact",
        "privacyPolicyURL": "https://brewmark.io/privacy",
        "termsOfServiceURL": "https://brewmark.io/terms",
        "defaultPrompt": [
          "What grind setting should I use for pour over on my grinder?",
          "Convert a recipe's grind setting to my grinder",
          "Help me choose a grinder for pour over under $200"
        ],
        "brandColor": "#2C2416",
        "brandColorDark": "#FAF8F5",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "capabilities": [
          "Convert grind settings between grinders",
          "Grind settings and starting recipes by brew method",
          "Dial in by taste: next setting after a sour or bitter cup",
          "Shortlist grinders to buy"
        ]
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "commerce": false,
        "test_cases": {
          "positive": [
            {
              "description": "Convert a recipe's setting to the user's grinder",
              "prompt": "My recipe says 18 clicks on a Comandante C40 MK4. What's that on a Baratza Encore?",
              "tools_triggered": "convert_grind_setting",
              "expected_behavior": "Card shows both dials and the shared 0-100 scale: 18 clicks on the C40 MK4 is 11 on the Encore (both 17 on the scale). The reply says it is a starting point to adjust by taste. Tapping 'Too sour' in the card moves the Encore needle one step finer."
            },
            {
              "description": "Settings for every brew method on one grinder",
              "prompt": "What grind settings should I use on my Fellow Ode Gen 2?",
              "tools_triggered": "get_grinder_chart",
              "expected_behavior": "Card charts every brew method on the Ode's 1 to 11 dial, e.g. pour over (V60) 6.2 from Fellow's own chart, range 4 to 8, written as Fellow owners count the marks (6.2 = the second mark after 6). Tapping a method shows its dial, a starting recipe and the dial-in buttons."
            },
            {
              "description": "Single brew method question, grinder named loosely",
              "prompt": "what setting for french press on a baratza encore",
              "tools_triggered": "get_grinder_chart",
              "expected_behavior": "Resolves 'baratza encore' and passes method 'french press'. Card leads with French press: 28 from Baratza's own chart (range 24 to 31) on the Encore's dial, and a starting recipe of 1:15, 30 g to 450 g water, 200 F, 4 min."
            },
            {
              "description": "Adjust after tasting, with the coffee named",
              "prompt": "I brewed Stumptown Hair Bender at 22 on my Baratza Encore in a Kalita Wave and it tasted sour. What next?",
              "tools_triggered": "dial_in",
              "expected_behavior": "Card leads with Pour over (flat bottom) on the Encore's dial at 21, one step finer, with 'Tasted sour at 22, so one step finer', the starting recipe (1:16.7, 20 g to 334 g water, 205 F, 3 min) and the dial-in buttons."
            },
            {
              "description": "Choosing a grinder to buy",
              "prompt": "Which grinder should I get for pour over? I don't want to spend more than $250.",
              "tools_triggered": "find_grinder",
              "expected_behavior": "Card shows a carousel of up to six grinders under $250 with maker photos, approximate prices, the pour-over setting on each, and a 'Buying guide' button that opens that grinder's page on brewmark.io. No retailer links in the card or reply."
            }
          ],
          "negative": [
            {
              "description": "Coffee question with no grinder involved: should answer without BrewMark",
              "prompt": "What water temperature should I use for a V60?"
            },
            {
              "description": "Unrelated request: BrewMark should not be called",
              "prompt": "Write me a haiku about Monday mornings."
            },
            {
              "description": "Purchase request: BrewMark does not sell grinders and should not act",
              "prompt": "Order me a Baratza Encore."
            }
          ]
        },
        "commerce_description": "BrewMark does not sell products or process payments. Its tools return grind settings and, when someone is choosing a grinder, a shortlist that links only to BrewMark's own buying guides on brewmark.io. Those guide pages carry retailer links (Amazon Associates), so BrewMark may earn a referral commission on purchases made there; nothing is bought inside ChatGPT.",
        "demo_recording_url": "https://youtu.be/7G7Y_dC-MDw"
      },
      "publication": {
        "release_notes": "New: tell it how your coffee tasted and it gives the next setting to try, on the card, with a Dialed in button. Settings for your grinder can now take the roast into account."
      },
      "apps": "./.app.json"
    }
  }
}