.codex-plugin/plugin.json

{
  "name": "chord-transposer",
  "version": "2.0.1",
  "description": "Change keys, compare capo shapes, and print chord sheets.",
  "author": {
    "name": "Zovo",
    "email": "support@zovo.one",
    "url": "https://zovo.one"
  },
  "homepage": "https://chord-transposer.zovo.one",
  "license": "Proprietary",
  "keywords": [
    "chord transposer",
    "transpose chords",
    "change key of song",
    "transpose guitar chords",
    "capo chart",
    "capo calculator",
    "chord sheet transposer",
    "song key changer",
    "ukulele chord transposer",
    "transpose to a lower key"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Keyshift Chord Transposer",
    "shortDescription": "Change keys and capo shapes",
    "longDescription": "Keyshift Chord Transposer is an entertainment tool for playing chord sheets on guitar or ukulele. Paste chords above your own lyrics or ChordPro inline brackets, then change the key by semitones, a named key pair or a capo fret. Roots and slash bass notes move while quality text stays in place. Chord starts keep their columns unless longer names collide; later chords then move right with a separating space. Tabs use 8-column stops.\n\nThe live monospaced sheet has down and up semitone controls. A capo chart shows frets 0 to 9, the shapes to play and counts of easy open chord names. Transposition includes a printable PDF in a monospaced layout; long lines continue at shared column boundaries and chord/lyric pairs stay together.\n\nLimits: 12,000 characters per sheet, semitone input -11 to +11, capo frets 0 to 9, and capo lists of 1 to 100 chords. Chord names only; no audio, tablature or staff notation. The key estimate uses the first and last chord and can be wrong for songs that change key. The PDF prints Latin, Greek, Cyrillic, Vietnamese, Chinese, Japanese and Korean lyrics. Chinese, Japanese and Korean characters take two columns, so chords stay over the right syllable. Right-to-left scripts such as Hebrew and Arabic, and emoji, get a note instead of a PDF. Lyrics are kept in widget-only metadata and an encrypted stateless download link, with no server-side lyric storage.",
    "developerName": "Zovo",
    "category": "Entertainment",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://chord-transposer.zovo.one",
    "supportURL": "https://chord-transposer.zovo.one/support",
    "privacyPolicyURL": "https://chord-transposer.zovo.one/privacy",
    "termsOfServiceURL": "https://chord-transposer.zovo.one/terms",
    "defaultPrompt": [
      "Transpose C  F  G  Am from C to F. Lyrics: Lanterns glow beside the gate.",
      "Find capo options for the sounding chords D, G, A and Bm, for frets 0 to 9.",
      "Show this chord sheet with key Am and semitone controls: [Am]Lantern [F]garden [C]glows [G]softly."
    ],
    "brandColor": "#7C3AED",
    "brandColorDark": "#A78BFA",
    "composerIcon": "./assets/icon.svg",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/chord-transposer/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "prompt": "{\"sheet\": \"Key: C\\nC        F        G\\nLanterns glow beside the gate\\nAm       F        C\\nPaper stars drift past the pond\", \"from_key\": \"C\", \"to_key\": \"G\"}",
              "tools_triggered": "transpose_chords",
              "expected_behavior": "Transposed from C to G (+7 semitones); 6 chords, 4 unique chords, 2 lyric lines.\nC -> G\nF -> C\nG -> D\nAm -> Em\nFrom the supplied origin key.\nCapo 7 with C shapes sounds in G.",
              "description": "Verified original example 1"
            },
            {
              "prompt": "{\"sheet\": \"C  G  Am  F\", \"from_key\": \"C\", \"semitones\": -3}",
              "tools_triggered": "transpose_chords",
              "expected_behavior": "Transposed from C to A (-3 semitones); 4 chords, 4 unique chords, 0 lyric lines.\nC -> A\nG -> E\nAm -> F#m\nF -> D\nFrom the supplied origin key.\nCapo 9 with C shapes sounds in A.",
              "description": "Verified original example 2"
            },
            {
              "prompt": "{\"key\": \"D\"}",
              "tools_triggered": "find_capo_options",
              "expected_behavior": "Capo frets 0 to 9 for D. Shape pitch plus fret equals sounding pitch.\nFret 0: D, Em, F#m, G, A, Bm, C#dim; 4 easy open chords.\nFret 1: Db, Ebm, Fm, Gb, Ab, Bbm, Cdim; 0 easy open chords.\nFret 2: C, Dm, Em, F, G, Am, Bdim; 5 easy open chords.\nFret 3: B, C#m, D#m, E, F#, G#m, A#dim; 1 easy open chords.\nFret 4: Bb, Cm, Dm, Eb, F, Gm, Adim; 1 easy open chords.\nFret 5: A, Bm, C#m, D, E, F#m, G#dim; 3 easy open chords.\nFret 6: Ab, Bbm, Cm, Db, Eb, Fm, Gdim; 0 easy open chords.\nFret 7: G, Am, Bm, C, D, Em, F#dim; 5 easy open chords.\nFret 8: Gb, Abm, Bbm, B, Db, Ebm, Fdim; 0 easy open chords.\nFret 9: F, Gm, Am, Bb, C, Dm, Edim; 3 easy open chords.",
              "description": "Verified original example 3"
            },
            {
              "prompt": "{\"sheet\": \"C Cm D Dm Em E F Fm G Gm A Am B Bdim\", \"from_key\": \"C\"}",
              "tools_triggered": "show_chord_sheet",
              "expected_behavior": "Transposed from C to C (+0 semitones); 14 chords, 14 unique chords, 0 lyric lines.\nC -> C\nCm -> Cm\nD -> D\nDm -> Dm\nEm -> Em\nE -> E\nF -> F\nFm -> Fm\nG -> G\nGm -> Gm\nA -> A\nAm -> Am\nB -> B\nBdim -> Bdim\nFrom the supplied origin key.",
              "description": "Verified original example 4"
            },
            {
              "prompt": "{\"sheet\": \"D/F#  G  A\", \"from_key\": \"D\", \"to_key\": \"E\"}",
              "tools_triggered": "transpose_chords",
              "expected_behavior": "Transposed from D to E (+2 semitones); 3 chords, 3 unique chords, 0 lyric lines.\nD/F# -> E/G#\nG -> A\nA -> B\nFrom the supplied origin key.\nCapo 2 with D shapes sounds in E.",
              "description": "Verified original example 5"
            }
          ],
          "negative": [
            {
              "prompt": "Transpose this audio recording for me.",
              "description": "No tool call; chord names only, no audio input."
            },
            {
              "prompt": "Turn this guitar tablature into staff notation.",
              "description": "No tool call; tablature and staff notation are outside the tool limits."
            },
            {
              "prompt": "Write the lyrics of a published song.",
              "description": "No tool call; the user supplies their own chord sheet."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://chord-transposer.zovo.one/dl/demo/q64FAA"
      },
      "publication": {
        "countries": [],
        "release_notes": "The PDF now prints lyrics in Latin, Greek, Cyrillic, Vietnamese, Chinese, Japanese and Korean with a monospaced Noto font; chords stay aligned by display columns. Right-to-left lyrics and emoji get a note instead of a PDF, and the transposition still succeeds.",
        "translations": {
          "pl-PL": {
            "subtitle": "Zmie\u0144 tonacj\u0119 i akordy",
            "description": "Transponuj arkusze akord\u00f3w i por\u00f3wnuj pozycje kapodastra od 0 do 9. Obs\u0142ugiwane s\u0105 akordy nad tekstem i zapis ChordPro. Limit: 12 000 znak\u00f3w; PDF obs\u0142uguje alfabet \u0142aci\u0144ski, grecki, cyrylic\u0119, wietnamski, chi\u0144ski, japo\u0144ski i korea\u0144ski, bez pisma od prawej do lewej. Bez audio, tabulatur i nut. Szacowana tonacja mo\u017ce by\u0107 b\u0142\u0119dna."
          },
          "de-DE": {
            "subtitle": "Tonart und Capo \u00e4ndern",
            "description": "Transponieren Sie Akkordbl\u00e4tter und vergleichen Sie Capo-B\u00fcnde von 0 bis 9. Akkorde \u00fcber dem Text und ChordPro werden unterst\u00fctzt. Grenze: 12.000 Zeichen; PDF unterst\u00fctzt lateinische, griechische, kyrillische, vietnamesische, chinesische, japanische und koreanische Schrift, keine Schrift von rechts nach links. Kein Audio, keine Tabulatur oder Notenschrift. Die gesch\u00e4tzte Tonart kann falsch sein."
          },
          "es-ES": {
            "subtitle": "Cambia tonalidad y cejilla",
            "description": "Transpone hojas de acordes y compara cejillas de 0 a 9. Admite acordes sobre letras y ChordPro. L\u00edmite: 12.000 caracteres; el PDF admite alfabeto latino, griego, cir\u00edlico, vietnamita, chino, japon\u00e9s y coreano, sin escritura de derecha a izquierda. Sin audio, tablaturas ni partituras. La tonalidad estimada puede ser incorrecta."
          },
          "fr-FR": {
            "subtitle": "Tonalit\u00e9 et capo",
            "description": "Transposez des grilles et comparez les positions de capo de 0 \u00e0 9. Accords au-dessus du texte et ChordPro accept\u00e9s. Limite : 12 000 caract\u00e8res ; PDF en alphabets latin, grec, cyrillique, vietnamien, chinois, japonais et cor\u00e9en, sans \u00e9criture de droite \u00e0 gauche. Sans audio, tablature ni notation musicale. La tonalit\u00e9 estim\u00e9e peut \u00eatre incorrecte."
          },
          "ja-JP": {
            "subtitle": "\u30b3\u30fc\u30c9\u79fb\u8abf\u3068\u30ab\u30dd\u6bd4\u8f03",
            "description": "\u30b3\u30fc\u30c9\u30b7\u30fc\u30c8\u3092\u79fb\u8abf\u3057\u30010\u301c9\u30d5\u30ec\u30c3\u30c8\u306e\u30ab\u30dd\u306e\u5f62\u3092\u6bd4\u8f03\u3057\u307e\u3059\u3002\u6b4c\u8a5e\u306e\u4e0a\u306e\u30b3\u30fc\u30c9\u3068ChordPro\u306b\u5bfe\u5fdc\u3002\u4e0a\u9650\u306f12,000\u6587\u5b57\u3002PDF\u306f\u30e9\u30c6\u30f3\u6587\u5b57\u3001\u30ae\u30ea\u30b7\u30e3\u6587\u5b57\u3001\u30ad\u30ea\u30eb\u6587\u5b57\u3001\u30d9\u30c8\u30ca\u30e0\u8a9e\u3001\u4e2d\u56fd\u8a9e\u3001\u65e5\u672c\u8a9e\u3001\u97d3\u56fd\u8a9e\u306b\u5bfe\u5fdc\u3057\u3001\u53f3\u304b\u3089\u5de6\u306b\u66f8\u304f\u6587\u5b57\u306b\u306f\u975e\u5bfe\u5fdc\u3067\u3059\u3002\u97f3\u58f0\u3001\u30bf\u30d6\u8b5c\u3001\u4e94\u7dda\u8b5c\u306b\u306f\u975e\u5bfe\u5fdc\u3002\u63a8\u5b9a\u30ad\u30fc\u306f\u8aa4\u308b\u5834\u5408\u304c\u3042\u308a\u307e\u3059\u3002"
          },
          "pt-BR": {
            "subtitle": "Mude o tom e o capotraste",
            "description": "Transponha cifras e compare posi\u00e7\u00f5es de capotraste de 0 a 9. Aceita acordes acima da letra e ChordPro. Limite: 12.000 caracteres; PDF aceita alfabeto latino, grego, cir\u00edlico, vietnamita, chin\u00eas, japon\u00eas e coreano, sem escrita da direita para a esquerda. Sem \u00e1udio, tablatura ou partitura. O tom estimado pode estar incorreto."
          }
        }
      }
    }
  },
  "apps": "./.app.json"
}