{
  "markdown": "# Aria by Patchline\n\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-Plugin-D97757)](https://docs.claude.com/en/docs/claude-code/plugins)\n[![License: MIT](https://img.shields.io/badge/License-MIT-0068FF)](./LICENSE)\n[![Version](https://img.shields.io/badge/version-0.2.2-00E6E2)](./CHANGELOG.md)\n[![MCP](https://img.shields.io/badge/MCP-aria-002772)](https://www.patchline.ai/mcp)\n\n**Ship a music release end-to-end without leaving Claude Desktop, Cowork, or Claude Code.**\n\nAria is a Claude plugin for Claude Code and Claude Desktop/Cowork that walks artists and managers through a release lifecycle from raw idea or finished track to pitched, released, and live on a smart link. Every artifact it produces is grounded in your real catalog and real streaming data via the Patchline MCP. No hallucinated playlists. No invented metrics.\n\n```bash\n# In Claude Code\n/plugin marketplace add Patchline-AI/aria\n/plugin install aria@patchline-ai\n/reload-plugins\n```\n\nAfter `/reload-plugins`, approve the Aria MCP server if Claude Code asks.\nThen run `/mcp`, choose `plugin:aria:aria`, and authenticate with your\nPatchline account. Once the server shows connected, start in plain language:\n\n```text\nget started\n```\n\n`get_started` reports what's in your workspace (artists, tracks, releases) and\nthe single best next action. From there, just say what you want — \"drop my new\nsingle\", \"make a smart link\", \"how are my fans doing\" — or\ninvoke a skill directly (`/aria:drop`, `/aria:link`,\n`/aria:fans`, `/aria:operator`). Nothing chains; each skill is a standalone, single-job moment.\n\nOn Claude Desktop/Cowork, install the same plugin package through the app's\nplugin flow and use the same natural-language prompts.\n\n### Cursor\n\nAria also ships as a native Cursor plugin. Its stable plugin identifier remains\n`aria`, while Cursor registers the MCP connection as **Aria** from the separate\nroot `mcp.json`. The bundled Patchline logo is used by Cursor plugin and\nmarketplace surfaces. Cursor controls the MCP connection-card chrome itself, so\nsome builds may still render the generic chain icon even when the plugin logo is\ninstalled correctly.\n\nWhen upgrading from 0.2.1 or an older Claude-format install, remove the existing\nAria plugin in Cursor's Customize view, install the current `Patchline-AI/aria`\nplugin, then run **Developer: Reload Window**. Confirm Settings > MCP contains\nexactly one entry named **Aria**; remove a separately configured lowercase\n`aria` entry rather than running both registrations.\n\nIf you are iterating on the plugin itself and want Claude Desktop/Cowork to\nload your local working copy instead of the published `Patchline-AI/aria`\nrelease, see [TROUBLESHOOTING - Testing unreleased changes from a local clone](./TROUBLESHOOTING.md#testing-unreleased-changes-from-a-local-clone).\nIf `/reload-plugins` reports \"not available on this environment\", see\n[TROUBLESHOOTING - `/reload-plugins` says \"not available on this environment\"](./TROUBLESHOOTING.md#reload-plugins-says-not-available-on-this-environment).\n\nUse the artist profile URL first, not a track, album, or playlist URL. If you\ndo not have the Spotify profile URL yet, type the artist name and Aria will\nsearch your Patchline roster/index.\n\n---\n\n## What you get\n\n- **Four lean \"moment\" skills** — each does one valuable thing end-to-end, grounded in your real Patchline data:\n  - `drop` — take a finished track from a file to live on your storefront (upload → analyze → cover → store link)\n  - `link` — create and share a smart link for a track, with analytics\n  - `fans` — direct-to-fan: audience overview, geography, segments, store/surface analytics\n  - `operator` — the operating manual for driving the MCP correctly (safety gates, grounding, token-frugality)\n- **Pitch copy without a pitch skill:** use `generate_pitch` for draft submission copy and `create_asset_share` for a shareable link (`create_pitch_link` is gated/hidden in the 49-tool build).\n- **The `aria` MCP server** — tools spanning catalog management, secure upload handoff, cover art, playlist targeting, artist intelligence, pitch generation, project/campaign creation, smart links, and audience analytics. Call `get_started` first if you're unsure where to begin.\n\n## How it's different from \"ChatGPT for music\"\n\nThis is not a tool explorer, and it's not a 10-step waterfall. Each skill is a single grounded action: it calls the `aria` MCP to ground every fact in your real catalog, artist intelligence, and track analysis — no invented playlists, no hallucinated metrics — and gets one job done fast. Both solo artists and labels use them.\n\n## Quickstart\n\n1. Run `/reload-plugins` and approve the Aria MCP server if prompted.\n2. Run `/mcp`, authenticate `plugin:aria:aria`, and wait for it to show connected.\n3. Say `get started` (or call the `get_started` tool) — Aria reports what you have (artists, tracks, releases) and the single best next step.\n4. From there, just say what you want: \"drop my new single\", \"make a smart link\", \"how are my fans doing\". Or invoke a skill directly: `/aria:drop`, `/aria:link`, `/aria:fans`, `/aria:operator`.\n\nNothing chains — each skill is standalone and can run any time. Skills produce a written artifact only if you ask; the default is a concise inline report.\n\n## Who this is for\n\n- Independent artists planning a release\n- Managers coordinating releases on behalf of artists\n- Labels running structured campaigns across multiple artists\n\n## Requirements\n\n- A [Patchline AI account](https://patchline.ai) (free tier available; some features are tier-gated post-launch)\n- Claude Code 1.x+ or Claude Desktop/Cowork with MCP and plugin support\n- An internet connection - the MCP server is hosted\n\n## First run - authentication\n\nThe first MCP call triggers a one-time Cognito OAuth flow in your browser. The token is persisted by Claude's MCP client. If the flow stalls:\n\n1. Close the browser tab.\n2. Run `/reload-plugins`.\n3. Run `/mcp` in Claude Code and reconnect `plugin:aria:aria`.\n4. Still stuck? See [TROUBLESHOOTING.md](./TROUBLESHOOTING.md).\n\nYou will never be asked for raw credentials, tokens, or AWS keys. The plugin does not need them.\n\n## Relationship to the Patchline web app\n\nThe plugin is the guided workspace for planning release artifacts inside Claude. The web app at [patchline.ai](https://patchline.ai) is where your catalog, storefront, billing, and social integrations live.\n\nPatchline also ships a Telegram companion bot for always-on mobile execution: paste links, trigger quick actions, and keep release momentum moving when you are away from your desk. Think of it as the 24/7 operator in your pocket; Aria is the structured planning room.\n\n## License + attribution\n\n- **Plugin code: [MIT License](./LICENSE).** Open source so artists, managers, and builders can inspect how the workflow is structured and adapt it for their own teams.\n- **MCP service: hosted + proprietary.** The `aria` MCP endpoint at `patchline.ai/api/mcp/v1` is Patchline-owned infrastructure, authenticated via Cognito. It requires a Patchline account.\n- **Inspired by the wider Claude music-tooling community.** We respect earlier experiments such as [`bitwize-music-studio/claude-ai-music-skills`](https://github.com/bitwize-music-studio/claude-ai-music-skills); Aria takes a different route by grounding release operations in Patchline's hosted catalog, artist intelligence, track analysis, and smart-link infrastructure.\n\n## Extending Aria\n\nAria is designed to be composable without exposing Patchline's full internal roadmap. If you want to contribute a skill, start with [CONTRIBUTING.md](./CONTRIBUTING.md). Each skill is a standalone moment (`drop`, `link`, `fans`, `operator`), MCP-grounded, with no shared phase state to maintain.\n\n## Links\n\n| | |\n|---|---|\n| Web app | [patchline.ai](https://patchline.ai) |\n| MCP landing | [patchline.ai/mcp](https://www.patchline.ai/mcp) |\n| Issues + feedback | [github.com/Patchline-AI/aria/issues](https://github.com/Patchline-AI/aria/issues) |\n| Changelog | [CHANGELOG.md](./CHANGELOG.md) |\n| Contributing | [CONTRIBUTING.md](./CONTRIBUTING.md) |\n| Code of conduct | [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md) |\n\n---\n\nBuilt by [Patchline AI](https://patchline.ai).\n",
  "bytes": 8215,
  "sha": "42b0f68ef6d74e60e35ebb50d2719bdf70dd2632c9f74a2bf73b503649a86aed",
  "repo_slug": "patchline-ai/aria",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_patchline_ai_aria_aria_6adc7315/readme"
}