plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "needl",
  "version": "0.16.1",
  "description": "Your Needl vinyl collection, wishlist and listening history in ChatGPT.",
  "author": {
    "name": "Needl Vinyl LLC",
    "email": "support@needlvinyl.app",
    "url": "https://needlvinyl.app"
  },
  "homepage": "https://needlvinyl.app",
  "keywords": [
    "vinyl",
    "records",
    "music",
    "collection",
    "wishlist",
    "listening"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Needl",
        "shortDescription": "Your vinyl collection in chat",
        "longDescription": "Needl is the home for your vinyl. Connect your Needl account to ask about the records you own, the ones on your wishlist, and what you've been listening to, and see them as cards right in the chat.\n\nWhat you can do:\n- Browse your collection: \"what do I have by Radiohead?\", your top-rated or most-played records, recent additions.\n- Open a record: its pressing, colour, label and catalogue number, what you paid, how often you've played it, and the tracklist cut into each side (from Discogs).\n- Your wishlist: see what you want most, change a record's Desire level, add a pressing, or mark one as bought.\n- Shuffle: let Needl pick something from your shelf to play, the same Shuffle as in the app.\n- Listening: your vinyl and CD sessions, your Apple Music and Spotify plays, top artists, and your monthly Pressed recap.\n\nYou choose what to share when you connect: your collection is always included; wishlist, wishlist changes, listening history and Shuffle can each be switched off. Needl only works with your own account, never edits or removes records you own, and does not share market prices. Requires a Needl account (the Needl app for iPhone). The view is available in English and 20 other languages.",
        "developerName": "Needl Vinyl LLC",
        "category": "Entertainment",
        "capabilities": [
          "Browse your record collection",
          "Show record and pressing details",
          "Manage your wishlist",
          "Shuffle a record to play",
          "Review your listening history"
        ],
        "websiteURL": "https://needlvinyl.app",
        "supportURL": "https://needlvinyl.app/support",
        "privacyPolicyURL": "https://needlvinyl.app/privacy",
        "termsOfServiceURL": "https://needlvinyl.app/terms",
        "defaultPrompt": [
          "Show me my top-rated records.",
          "What's on my wishlist?",
          "Pick a record for me to play tonight."
        ],
        "brandColor": "#2A6CC0",
        "brandColorDark": "#6FA8F0",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Rank the user's own records by their ratings and show them.",
              "prompt": "Show me my top-rated records.",
              "tools_triggered": "show_top_records",
              "expected_behavior": "A numbered list of the account's highest-rated records, five-star records first (OK Computer, Thriller, Blonde, A Love Supreme), each with its rating. No records from other accounts."
            },
            {
              "description": "Everything the user has by one artist.",
              "prompt": "What do I have by Radiohead?",
              "tools_triggered": "show_artist",
              "expected_behavior": "Shows the two Radiohead records the account owns (OK Computer, In Rainbows), and separately any Radiohead albums in Needl's catalogue the user doesn't own, without calling that a full discography."
            },
            {
              "description": "Read the wishlist, most wanted first.",
              "prompt": "What's on my wishlist?",
              "tools_triggered": "search_my_wishlist, show_records",
              "expected_behavior": "Shows the six wishlist entries, most wanted first: Rihanna's Anti (Holy Grail) at the top, then Portishead's Roseland NYC Live and Tame Impala's The Slow Rush (Must Have), and so on."
            },
            {
              "description": "Summarise physical listening for a month.",
              "prompt": "What did I listen to on vinyl in September 2026?",
              "tools_triggered": "show_listening",
              "expected_behavior": "Shows September 2026 vinyl and CD listening: 11 sessions across 9 albums, with OK Computer the most played. Figures are described as sessions, not hours."
            },
            {
              "description": "Pick a record with Shuffle, with a filter.",
              "prompt": "Pick a jazz record for me to play tonight.",
              "tools_triggered": "shuffle_records",
              "expected_behavior": "Picks one of the account's jazz records (A Love Supreme or In A Silent Way) and shows it as a card. The assistant says it was picked, not that it is playing. Shuffle works through the collection in rounds, so once both jazz records have been picked it explains that nothing is left this round instead of repeating one."
            }
          ],
          "negative": [
            {
              "description": "Market value is not shared with assistants; the assistant should say Needl doesn't share it here, offer what the user paid if recorded, and not estimate a value.",
              "prompt": "How much is my copy of Thriller worth on the market?"
            },
            {
              "description": "The plugin can never delete or edit records the user owns; the assistant should say so and point to the Needl app.",
              "prompt": "Delete OK Computer from my collection."
            },
            {
              "description": "The plugin only reads the signed-in account; it has no way to look up other people's collections and should say so.",
              "prompt": "Show me my friend Alex's record collection."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Needl does not sell products or process payments in ChatGPT. Marking a wishlist record as bought only records that the user owns it.",
        "demo_recording_url": "https://drive.google.com/file/d/1fs8xuaZ7FLQkQ-LCDaJ8jxsDI5GZUjPz/view?usp=sharing"
      },
      "publication": {
        "release_notes": "First release of Needl for ChatGPT: browse your collection and wishlist, open records with pressing details and tracklists, change Desire, add to the wishlist or mark as bought, pick with Shuffle, and review your vinyl and streaming listening. The in-chat view is available in 21 languages.",
        "translations": {
          "es-ES": {
            "subtitle": "Tus vinilos en el chat",
            "description": "Conecta tu cuenta de Needl para preguntar por los discos que tienes, tu lista de deseos y lo que has escuchado, y verlos como tarjetas en el chat. T\u00fa eliges qu\u00e9 compartir; Needl solo accede a tu propia cuenta y nunca edita ni elimina tus discos."
          },
          "fr-FR": {
            "subtitle": "Vos vinyles dans le chat",
            "description": "Connectez votre compte Needl pour interroger vos disques, votre liste de souhaits et vos \u00e9coutes, et les voir sous forme de cartes dans le chat. Vous choisissez ce qui est partag\u00e9 ; Needl n\u2019acc\u00e8de qu\u2019\u00e0 votre propre compte et ne modifie ni ne supprime jamais vos disques."
          },
          "de-DE": {
            "subtitle": "Deine Platten im Chat",
            "description": "Verbinde dein Needl-Konto, um nach deinen Platten, deiner Wunschliste und deinem H\u00f6rverlauf zu fragen und sie als Karten im Chat zu sehen. Du entscheidest, was geteilt wird; Needl greift nur auf dein eigenes Konto zu und \u00e4ndert oder l\u00f6scht nie deine Platten."
          },
          "ja-JP": {
            "subtitle": "\u3042\u306a\u305f\u306e\u30ec\u30b3\u30fc\u30c9\u3092\u30c1\u30e3\u30c3\u30c8\u3067",
            "description": "Needl\u30a2\u30ab\u30a6\u30f3\u30c8\u3092\u63a5\u7d9a\u3059\u308b\u3068\u3001\u6240\u6709\u3057\u3066\u3044\u308b\u30ec\u30b3\u30fc\u30c9\u3001\u30a6\u30a3\u30c3\u30b7\u30e5\u30ea\u30b9\u30c8\u3001\u30ea\u30b9\u30cb\u30f3\u30b0\u5c65\u6b74\u306b\u3064\u3044\u3066\u30c1\u30e3\u30c3\u30c8\u3067\u8cea\u554f\u3057\u3001\u30ab\u30fc\u30c9\u3067\u8868\u793a\u3067\u304d\u307e\u3059\u3002\u5171\u6709\u3059\u308b\u5185\u5bb9\u306f\u3042\u306a\u305f\u304c\u9078\u3079\u307e\u3059\u3002Needl\u304c\u30a2\u30af\u30bb\u30b9\u3059\u308b\u306e\u306f\u3042\u306a\u305f\u81ea\u8eab\u306e\u30a2\u30ab\u30a6\u30f3\u30c8\u3060\u3051\u3067\u3001\u3042\u306a\u305f\u306e\u30ec\u30b3\u30fc\u30c9\u3092\u7de8\u96c6\u30fb\u524a\u9664\u3059\u308b\u3053\u3068\u306f\u3042\u308a\u307e\u305b\u3093\u3002"
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}