plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "songstead",
  "version": "1.0.0",
  "description": "Add songs with their chord charts, build setlists in the right keys, and find anything in your Songstead library.",
  "author": {
    "name": "Songstead",
    "email": "contact@songstead.app",
    "url": "https://songstead.app"
  },
  "homepage": "https://songstead.app",
  "keywords": [
    "music",
    "chord charts",
    "setlists",
    "band",
    "worship"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Songstead",
        "shortDescription": "Settle in. Play on.",
        "longDescription": "Songstead is a home for your songs: every chord chart and setlist in one place, synced across your devices, for solo musicians and bands alike. Connect it to ChatGPT and you can work on your library just by asking.\n\nChatGPT can add a song with its chord chart, in ChordPro or chords over lyrics, and fill in the key, artist, tempo, time signature and duration. It can build a setlist for your next gig or service, put the songs in order, and set the key each one is played in. It can find songs by tag, set or group, rename and merge tags, and attach a PDF or image chart you share in the chat or from a link.\n\nChatGPT works with exactly what you can see in Songstead, under your own permissions, including the team groups you share with your band. Anything it changes shows up in the app right away for everyone in the group.\n\nWhen you connect, you choose read-only or edit access, and you can disconnect at any time from Settings \u2192 Account in Songstead. ChatGPT can't delete songs, sets, charts, tags or files, so that always stays in your hands in Songstead.",
        "developerName": "Songstead",
        "category": "Productivity",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://songstead.app",
        "supportURL": "https://songstead.app/contact",
        "privacyPolicyURL": "https://songstead.app/privacy",
        "termsOfServiceURL": "https://songstead.app/terms",
        "defaultPrompt": [
          "Add Amazing Grace to my Songstead library with a chord chart in G.",
          "Build a Songstead set for Sunday from my songs, each in the key I usually play it in.",
          "Which of my Songstead songs are in D, and which sets are they in?"
        ],
        "brandColor": "#E74C3C",
        "brandColorDark": "#F0604F",
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Add a song with its chord chart",
              "prompt": "Add Amazing Grace to my Songstead library with a chord chart in G.",
              "tools_triggered": "group__read, key_signature__read, song__create, chart__create",
              "expected_behavior": "Creates the song in the personal group with its artist, tempo and time signature filled in, then adds a chord chart with chords and lyrics written in G and its written key set to G. Replies with a link to the song."
            },
            {
              "description": "Build a setlist in each song's usual key",
              "prompt": "Make a Songstead set called Morning Service for this Sunday with four of my songs, each in the key I usually play it in.",
              "tools_triggered": "song__read, set__create, set_song__create",
              "expected_behavior": "Creates a set named Morning Service dated this Sunday and adds four songs from the same group. Each set song's key is the user's own key for that song where one is saved, otherwise the written key of its chart. Replies with a link to the set."
            },
            {
              "description": "Find songs by key and the sets they are in",
              "prompt": "Which of my Songstead songs have a chart in D, and which sets are they in?",
              "tools_triggered": "key_signature__read, chart__read, song__read",
              "expected_behavior": "Lists the songs that have a chart written in D and, for each, the sets that include it. Songs in no set are listed as such."
            },
            {
              "description": "Reorder a set",
              "prompt": "In my Morning Service set in Songstead, move the last song to the top.",
              "tools_triggered": "set__read, set__reorder",
              "expected_behavior": "Moves the last song to the first position and keeps the other songs in their existing order. Replies with the new running order and a link to the set."
            },
            {
              "description": "Tag the songs in a set",
              "prompt": "Tag every song in my Morning Service set in Songstead with a tag called Sunday, creating the tag if it doesn't exist.",
              "tools_triggered": "song__read, tag__read, tag__create, song_tag__create",
              "expected_behavior": "Creates a Sunday tag in the set's group if none exists, then puts it on each song in the set that doesn't already carry it. Replies with the songs it tagged."
            }
          ],
          "negative": [
            {
              "description": "Deleting content is not supported",
              "prompt": "Delete all of my songs in Songstead.",
              "expected_behavior": "Deletes nothing. Explains that it can't delete songs and that the user can do that in Songstead."
            },
            {
              "description": "Billing and plans are not exposed",
              "prompt": "Cancel my Songstead subscription.",
              "expected_behavior": "Calls no tools. Explains that it can't change plans or billing and that the user manages that in Songstead."
            },
            {
              "description": "Access outside the connected account",
              "prompt": "Show me the songs in my friend Sam's Songstead library.",
              "expected_behavior": "Shows only songs from groups the connected account belongs to. Explains that it can't see another person's library unless they share a group with the user."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Initial release: add songs and chord charts, build and reorder setlists, find songs by key, tag and set, and attach PDF or image charts."
      },
      "apps": "./.app.json"
    }
  }
}