plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "familywell",
  "version": "1.1.0",
  "description": "Read and update your family's to-dos, shopping lists, calendar, spending, recipes, home inventory and cars in FamilyWell, with the access you choose for each module.",
  "author": {
    "name": "FamilyWell",
    "email": "hello@familywell.org",
    "url": "https://familywell.org"
  },
  "homepage": "https://familywell.org/ai/",
  "repository": "https://github.com/bvdr/familywell",
  "license": "PolyForm-Noncommercial-1.0.0",
  "keywords": [
    "family",
    "household",
    "shopping list",
    "to-do",
    "calendar",
    "budget",
    "recipes",
    "car maintenance"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "FamilyWell",
        "shortDescription": "Your family, organized",
        "longDescription": "FamilyWell is the shared organizer for the people you live with. With this plugin, ChatGPT can tell you what's on today, add to the shopping list, log an expense, plan a car service, scale a recipe and add what's missing to the list, or tick off a task, right from the chat. You pick one family and set each module to No access, Read or Read & write before anything is shared. Answers come back as live cards you can tick off in the chat.",
        "developerName": "FamilyWell",
        "category": "Productivity",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://familywell.org/ai/",
        "supportURL": "https://familywell.org/docs/mcp/#support",
        "privacyPolicyURL": "https://familywell.org/privacy/",
        "termsOfServiceURL": "https://familywell.org/terms/",
        "defaultPrompt": [
          "What's on for us today?",
          "Add two lemons and maple syrup to our Weekly groceries list.",
          "The Camry is at 98,900 miles. What maintenance is due?"
        ],
        "brandColor": "#121100",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png",
        "brandColorDark": "#FFDF00"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Show what's due for the family today.",
              "prompt": "What's on for us today in FamilyWell?",
              "tools_triggered": "get_today",
              "expected_behavior": "Summarises the Millers' day: overdue \"Replace furnace filter\", \"Call the plumber about the upstairs faucet\" due today, the Lake Tahoe trip in progress, Noah's swim practice and Emma's permission slip tomorrow, and overdue car maintenance (CR-V oil change, Camry battery), each with a link to open it in FamilyWell."
            },
            {
              "description": "Add items to a named shopping list and flag one that is already on it.",
              "prompt": "Add eggs, two lemons and maple syrup to our Weekly groceries list in FamilyWell.",
              "tools_triggered": "shopping_list_shopping_lists, shopping_add_item",
              "expected_behavior": "Finds the \"Weekly groceries\" list (Trader Joe's) and adds lemons (quantity 2) and maple syrup. Eggs are already on the list (1 dozen, not bought), so it says so instead of silently adding a duplicate."
            },
            {
              "description": "Record a household expense and let FamilyWell pick the category.",
              "prompt": "Log $64.20 spent at Trader Joe's today on groceries in FamilyWell.",
              "tools_triggered": "spending_add_expense",
              "expected_behavior": "Records one expense of 64.20 USD dated today, shop Trader Joe's, category Food, on the family's default \"Others\" spending list, and confirms it with a link. It does not move or pay any money."
            },
            {
              "description": "Scale a recipe and put its ingredients on a shopping list.",
              "prompt": "Scale our Sunday pancakes recipe to 8 servings and add the ingredients to the Weekly groceries list.",
              "tools_triggered": "recipes_list, recipes_scale, shopping_list_shopping_lists, recipes_add_to_shopping",
              "expected_behavior": "Finds \"Sunday pancakes\" (4 servings), doubles it (500 g flour, 1 l buttermilk, 4 eggs, 4 tbsp sugar, 4 tsp baking powder) and adds those to \"Weekly groceries\". Salt has no amount, so it is skipped. The recipe itself is not changed."
            },
            {
              "description": "Log a car's odometer and report the maintenance that is due.",
              "prompt": "The Camry is at 98,900 miles. Update it in FamilyWell and tell me what maintenance is due.",
              "tools_triggered": "vehicles_list, vehicles_log_mileage, vehicles_get",
              "expected_behavior": "Records the new reading for the 2016 Toyota Camry (sent in km, about 159,164 km), then reports the battery and coolant flush as overdue by date and the tires as due at about 99,200 miles. The oil change is not due yet."
            },
            {
              "description": "Read the marks on the days of a multi-day event.",
              "prompt": "Which days of our Lake Tahoe trip are boat days in FamilyWell?",
              "tools_triggered": "calendar_list_entries, calendar_get_event",
              "expected_behavior": "Finds the Lake Tahoe trip (it started two days ago and ends in five days) and says the \"Boat day\" mark is on tomorrow and the day after (days 4 and 5 of 8), with a link to the event."
            },
            {
              "description": "Mark one day of a multi-day event with a short label.",
              "prompt": "In FamilyWell, mark the last day of our Lake Tahoe trip as \"Drive home\".",
              "tools_triggered": "calendar_list_entries, calendar_add_mark",
              "expected_behavior": "Finds the Lake Tahoe trip and adds a \"Drive home\" mark on its last day (five days from today), then confirms with a link. The trip's dates and its \"Boat day\" mark are unchanged."
            }
          ],
          "negative": [
            {
              "description": "Do not invoke FamilyWell to pay a bill. The plugin should not be invoked because FamilyWell only records expenses; it cannot move money or pay bills.",
              "prompt": "Pay our electricity bill of $120."
            },
            {
              "description": "Do not invoke FamilyWell to order groceries from a shop. The plugin should not be invoked because FamilyWell keeps shopping lists but does not place orders with shops or delivery services.",
              "prompt": "Order everything on my grocery list for home delivery tonight."
            },
            {
              "description": "Do not invoke FamilyWell for a general knowledge question. The plugin should not be invoked because the question is general advice and does not ask about the user's FamilyWell data.",
              "prompt": "How often should a car's brake fluid be changed?"
            }
          ]
        },
        "commerce": false
      },
      "publication": {
        "release_notes": "Calendar: read and change what is on each day of a multi-day event (day marks such as \"Fish allowed\" on a fast's Wednesdays and Fridays, a note per day, and to-dos for one day), and list, add and rename the family's calendar categories. Deleted marks and day notes can be restored for 30 days. Skills now use the current tool names."
      },
      "apps": "./.app.json"
    }
  }
}