{"_id":"audionaut-mcp","_rev":"6-8d4b3a023093879d8fd5dc5197549070","name":"audionaut-mcp","dist-tags":{"latest":"0.5.0"},"versions":{"0.2.0":{"name":"audionaut-mcp","version":"0.2.0","keywords":["mcp","mcp-server","modelcontextprotocol","claude","audio","audio-editor","multitrack","daw","agent"],"author":{"name":"Klaus Voltmer"},"license":"GPL-3.0-or-later","_id":"audionaut-mcp@0.2.0","maintainers":[{"name":"vltmrkls","email":"vltmrkls@gmail.com"}],"homepage":"https://audionaut.app/manual/11-cli-and-agents/","bugs":{"url":"https://github.com/kvoltmer/Audionaut/issues"},"bin":{"audionaut-mcp":"index.js"},"dist":{"shasum":"9269ec3f07f5af1f9b5a2f18441be32e6ced3df9","tarball":"https://registry.npmjs.org/audionaut-mcp/-/audionaut-mcp-0.2.0.tgz","fileCount":5,"integrity":"sha512-212RQOeilsPUSOv3piMF8VB5oj3tT5eELKJSAITmY5ocy64xPH5qAfrkpatbtSBb6JByBI/dB9Rfu/v2UjCI5w==","signatures":[{"sig":"MEQCIE9Ixt1qLXmKx2faTS7SN847WRArkplbQ1kgtCrPjuGYAiBWSBjk3YaTIPWMD8rcdchY9OPNKfodv++me6Bt111qpA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":91360},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"55fdb8453d3d4f574f3e27d79b1b08cff1a9c8d6","mcpName":"io.github.kvoltmer/audionaut","scripts":{"test":"node test.mjs"},"_npmUser":{"name":"vltmrkls","email":"vltmrkls@gmail.com"},"repository":{"url":"git+https://github.com/kvoltmer/Audionaut.git","type":"git","directory":"Tools/audionaut-mcp"},"_npmVersion":"11.12.1","description":"MCP server for the Audionaut multitrack audio editor - lets Claude and other agents edit .audium projects","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/audionaut-mcp_0.2.0_1790683768506_0.42550461233880865","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"audionaut-mcp","version":"0.3.0","keywords":["mcp","mcp-server","modelcontextprotocol","claude","audio","audio-editor","multitrack","daw","agent"],"author":{"name":"Klaus Voltmer"},"license":"GPL-3.0-or-later","_id":"audionaut-mcp@0.3.0","maintainers":[{"name":"vltmrkls","email":"vltmrkls@gmail.com"}],"homepage":"https://audionaut.app/manual/11-cli-and-agents/","bugs":{"url":"https://github.com/kvoltmer/Audionaut/issues"},"bin":{"audionaut-mcp":"index.js"},"dist":{"shasum":"b0db7b5bfb851b579d39ad0027ec97f660e5bff7","tarball":"https://registry.npmjs.org/audionaut-mcp/-/audionaut-mcp-0.3.0.tgz","fileCount":5,"integrity":"sha512-qLgM33WHWFzUVaep0l76VpXUa1ieVj/N/24ft1f8yPOd4C0ejK2YpCrTVMxcggTEwdzPp9Y4fz0JMVLUDUDSfw==","signatures":[{"sig":"MEUCIQCvRVkDpvS4ykxLSMpQbPVFvuHOdhcWbqJWjXpn26e9EwIgDD1xV9vNLGSVuRL+CPo5H0D/SKTZDG4gsIWPWOnGmeY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIHByeTz5k37FF9Oo4no7gkKbrGJqgitue/tw+4u9X7tfAiBlt2aVNmbXleyKmSRORDoCtj/pVMZJm1FCg9jYD0F8AQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92971},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"6cc19ff47fae5ad18d88b1be7bd003c8ee52b2bd","mcpName":"io.github.kvoltmer/audionaut","scripts":{"test":"node test.mjs"},"_npmUser":{"name":"vltmrkls","email":"vltmrkls@gmail.com"},"repository":{"url":"git+https://github.com/kvoltmer/Audionaut.git","type":"git","directory":"Tools/audionaut-mcp"},"_npmVersion":"11.12.1","description":"MCP server for the Audionaut multitrack audio editor - lets Claude and other agents edit .audium projects","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/audionaut-mcp_0.3.0_1790924701935_0.5323318201123519","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"audionaut-mcp","version":"0.3.1","keywords":["mcp","mcp-server","modelcontextprotocol","claude","audio","audio-editor","multitrack","daw","agent"],"author":{"name":"Klaus Voltmer"},"license":"GPL-3.0-or-later","_id":"audionaut-mcp@0.3.1","maintainers":[{"name":"vltmrkls","email":"vltmrkls@gmail.com"}],"homepage":"https://audionaut.app/manual/11-cli-and-agents/","bugs":{"url":"https://github.com/kvoltmer/Audionaut/issues"},"bin":{"audionaut-mcp":"index.js"},"dist":{"shasum":"05bae3da9460a1a25218a58c5d167958f8e97359","tarball":"https://registry.npmjs.org/audionaut-mcp/-/audionaut-mcp-0.3.1.tgz","fileCount":5,"integrity":"sha512-zoRNtOGAKH2rRZnrAStKCbzdDbK13Gkgs2a7ftnzWNqyHbE9r2tq1uW91Ii7+EW8cY7341U/imJm3n7ePSnQfg==","signatures":[{"sig":"MEQCICVSF23cvxA2sirFt7HU6InyYJ3/fTaPRK3+X5DJtrfNAiBKQ8FOL0a1yZmnR/31LxDEKNMHdpsrE2Pr/l/SQ/DvYw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCzlCc8hbmfPMXvfb1s4TBVVzhKXcMk0njZR+n2GLxAGQIhALGtsrxTqsiM5u+ZzRW/dE35VOaPebYV43zJQPcBOy2o","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":93231},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"ea8a03de7d52b6b08014dcaa60441a1234b6f24e","mcpName":"io.github.kvoltmer/audionaut","scripts":{"test":"node test.mjs"},"_npmUser":{"name":"vltmrkls","email":"vltmrkls@gmail.com"},"repository":{"url":"git+https://github.com/kvoltmer/Audionaut.git","type":"git","directory":"Tools/audionaut-mcp"},"_npmVersion":"11.12.1","description":"MCP server for the Audionaut multitrack audio editor - lets Claude and other agents edit .audium projects. Requires the Audionaut app (Mac App Store / GitHub Releases)","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/audionaut-mcp_0.3.1_1791300857343_0.5931168380408269","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"audionaut-mcp","version":"0.4.0","keywords":["mcp","mcp-server","modelcontextprotocol","claude","audio","audio-editor","multitrack","daw","agent"],"author":{"name":"Klaus Voltmer"},"license":"GPL-3.0-or-later","_id":"audionaut-mcp@0.4.0","maintainers":[{"name":"vltmrkls","email":"vltmrkls@gmail.com"}],"homepage":"https://audionaut.app/manual/11-cli-and-agents/","bugs":{"url":"https://github.com/kvoltmer/Audionaut/issues"},"bin":{"audionaut-mcp":"index.js"},"dist":{"shasum":"104c0af4f3cb1dfb0065df1ad6a5c20fac923859","tarball":"https://registry.npmjs.org/audionaut-mcp/-/audionaut-mcp-0.4.0.tgz","fileCount":5,"integrity":"sha512-lUKcbNmW3EUHb+sx18TiVOHGeXm5+deUr+xzEA7UKxslRWLyevDg4UqG9soYJyUPYJRmk4ES6RSLqGIJ3/aiMQ==","signatures":[{"sig":"MEYCIQCBZJ1BMgJcTX172B6Rbw7lPs/p4okID588orv3/s/m5QIhAJrE0ZGojxnp4f00gLo5O42ztg201+uwJNga67mvct0b","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIAZAUFDIZXK8L8Jf6haFt8y6hW48fRGGeyCpsTHblH/HAiEAj8dTPdTOzLsXXyYnyGsblHLwEGU4Ac/iFynr7+ywEAo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":98209},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"56a4e00a453ae6a184085e0b215272dfdd36ec8d","mcpName":"io.github.kvoltmer/audionaut","scripts":{"test":"node test.mjs"},"_npmUser":{"name":"vltmrkls","email":"vltmrkls@gmail.com"},"repository":{"url":"git+https://github.com/kvoltmer/Audionaut.git","type":"git","directory":"Tools/audionaut-mcp"},"_npmVersion":"11.12.1","description":"MCP server for the Audionaut multitrack audio editor - lets Claude and other agents edit .audium projects. Requires the Audionaut app (Mac App Store / GitHub Releases)","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/audionaut-mcp_0.4.0_1791982786167_0.2267286977484162","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"audionaut-mcp","version":"0.4.1","keywords":["mcp","mcp-server","modelcontextprotocol","claude","audio","audio-editor","multitrack","daw","agent"],"author":{"name":"Klaus Voltmer"},"license":"GPL-3.0-or-later","_id":"audionaut-mcp@0.4.1","maintainers":[{"name":"vltmrkls","email":"vltmrkls@gmail.com"}],"homepage":"https://audionaut.app/manual/11-cli-and-agents/","bugs":{"url":"https://github.com/kvoltmer/Audionaut/issues"},"bin":{"audionaut-mcp":"index.js"},"dist":{"shasum":"6f6f1dcc08ee27a4ec0a3d3229416a3f1e09f242","tarball":"https://registry.npmjs.org/audionaut-mcp/-/audionaut-mcp-0.4.1.tgz","fileCount":5,"integrity":"sha512-mgKPWpUKTwYLx4sHxoIRil3pm4eDeBkuBSsvaIDG1udrjWtz6WckGIgZwvXEjf/YZKGlwkSa5FAfMvpQOrUcJg==","signatures":[{"sig":"MEUCIQDhKeRS35hyJO86B/cYBsbaAdx11FXZIwOVAX0UsdzvXAIgcrO1B17DYirMhoWdnWZYlONfgnrtfZL7zZjYbI3cNgE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIGaHBcVRTa5H26YMONow9ILZbR+VpL4TByRMrp4XMxghAiEA0P0ZLcL8YKuovCWgzDJ9gaeq75bHs+3yx7RNnu0nrZc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":100650},"main":"index.js","type":"module","engines":{"node":">=18"},"gitHead":"c92140fae6c8a1e0d71c13f8be2f81b74522bdb3","mcpName":"io.github.kvoltmer/audionaut","scripts":{"test":"node test.mjs"},"_npmUser":{"name":"vltmrkls","email":"vltmrkls@gmail.com"},"repository":{"url":"git+https://github.com/kvoltmer/Audionaut.git","type":"git","directory":"Tools/audionaut-mcp"},"_npmVersion":"11.12.1","description":"MCP server for the Audionaut multitrack audio editor - lets Claude and other agents edit .audium projects. Requires the Audionaut app (Mac App Store / GitHub Releases)","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/audionaut-mcp_0.4.1_1792574080611_0.8499814256602642","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"_id":"audionaut-mcp@0.5.0","bin":{"audionaut-mcp":"index.js"},"bugs":{"url":"https://github.com/kvoltmer/Audionaut/issues"},"dist":{"shasum":"17a4bfd60b2ee5296ef1525574a29467c1505b77","tarball":"https://registry.npmjs.org/audionaut-mcp/-/audionaut-mcp-0.5.0.tgz","fileCount":5,"integrity":"sha512-zERiEUUXJoq5BP0MMmmGGw5tnpwkgKSGqfAGqD7lTEAMWzCOlhwfkpIgWSFtnczPsqxLTelBmmUpgp4Rv3togg==","signatures":[{"sig":"MEYCIQCpJMinMo4jwmZ7o+pal7RygYQ1sEE0UFwobetQnzVLugIhAONom92FWh5v7aUkh1TYyHD7Te1/xFW2Z2z7Uq9l3mp4","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICzfigJUPshIBxKUX0HvkWc719YS0EhPtRBGiEFYGFiiAiEAsDYbJMkP1MAmhGWAUhymL+JkNNN94iG72rDRyAKRhGU="}],"unpackedSize":101809},"main":"index.js","name":"audionaut-mcp","type":"module","author":{"name":"Klaus Voltmer"},"engines":{"node":">=18"},"gitHead":"7109f4f487a0d723581378a457d2efcb95a961c6","license":"GPL-3.0-or-later","mcpName":"io.github.kvoltmer/audionaut","scripts":{"test":"node test.mjs"},"version":"0.5.0","_npmUser":{"name":"vltmrkls","email":"vltmrkls@gmail.com"},"homepage":"https://audionaut.app/manual/11-cli-and-agents/","keywords":["mcp","mcp-server","modelcontextprotocol","claude","audio","audio-editor","multitrack","daw","agent"],"repository":{"url":"git+https://github.com/kvoltmer/Audionaut.git","type":"git","directory":"Tools/audionaut-mcp"},"_npmVersion":"11.12.1","description":"MCP server for the Audionaut multitrack audio editor - lets Claude and other agents edit .audium projects. Requires the Audionaut app (Mac App Store / GitHub Releases)","directories":{},"maintainers":[{"name":"vltmrkls","email":"vltmrkls@gmail.com"}],"_nodeVersion":"25.9.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/audionaut-mcp_0.5.0_1792945235813_0.924917854272953"}}},"time":{"created":"2026-09-29T12:09:28.358Z","modified":"2026-10-25T16:20:36.297Z","0.2.0":"2026-09-29T12:09:28.719Z","0.3.0":"2026-10-02T07:05:02.042Z","0.3.1":"2026-10-06T15:34:17.444Z","0.4.0":"2026-10-14T12:59:46.244Z","0.4.1":"2026-10-21T09:14:40.699Z","0.5.0":"2026-10-25T16:20:35.918Z"},"bugs":{"url":"https://github.com/kvoltmer/Audionaut/issues"},"author":{"name":"Klaus Voltmer"},"license":"GPL-3.0-or-later","homepage":"https://audionaut.app/manual/11-cli-and-agents/","keywords":["mcp","mcp-server","modelcontextprotocol","claude","audio","audio-editor","multitrack","daw","agent"],"repository":{"url":"git+https://github.com/kvoltmer/Audionaut.git","type":"git","directory":"Tools/audionaut-mcp"},"description":"MCP server for the Audionaut multitrack audio editor - lets Claude and other agents edit .audium projects. Requires the Audionaut app (Mac App Store / GitHub Releases)","maintainers":[{"name":"vltmrkls","email":"vltmrkls@gmail.com"}],"readme":"# audionaut-mcp\n\nAn [MCP](https://modelcontextprotocol.io) server that lets AI agents (Claude\nCode, Claude Desktop, and any other MCP client) edit\n[Audionaut](https://audionaut.app) projects: cut, move, fade, analyse,\nauto-edit and export. It is a thin wrapper: every tool runs one Audionaut\ncommand with `--json` and relays the result — no engine logic lives here.\n\n**Requires the Audionaut app** ([Mac App Store](https://apps.apple.com/app/id6743627933) /\n[GitHub Releases](https://github.com/kvoltmer/Audionaut/releases)). On its own\nthis package does nothing.\n\n## Quick start\n\nYou need [Audionaut](https://audionaut.app/download) — 1.6.3 or later is\nrecommended; 1.6.2 works on macOS and Linux — and [Node.js](https://nodejs.org)\n18 or later.\n\nClaude Code:\n\n```\nclaude mcp add audionaut -- npx -y audionaut-mcp\n```\n\nClaude Desktop (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"audionaut\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"audionaut-mcp\"]\n    }\n  }\n}\n```\n\nOn Windows, if Claude Desktop cannot start `npx`, use\n`\"command\": \"cmd\", \"args\": [\"/c\", \"npx\", \"-y\", \"audionaut-mcp\"]`.\n\nThen ask for something like *\"split the clip in ~/Music/Audionaut/Demo\nProject.audium every 16 bars\"*. Keep the project open in Audionaut to watch\nthe edits arrive; each one is a single undo step.\n\n**On macOS, keep projects in your Music folder.** Audionaut is sandboxed\nthere (App Store and website download alike) and can only reach `~/Music`:\nprojects, audio to import and export targets all have to be inside it, for\nexample in `~/Music/Audionaut`. The server refuses other paths up front with\n`sandbox_denied` and a hint. Windows and Linux have no such limit.\n\nTo see which Audionaut the server found and whether it answers:\n\n```\nnpx -y audionaut-mcp --check\n```\n\nThe server looks for, in order: `AUDIONAUT_CLI`; a developer build of\n`audionaut-cli` (see the end of this page); `audionaut-cli` on `PATH`; the\ninstalled app — `/Applications` or `~/Applications` (or wherever Spotlight\nfinds it) on macOS, `Program Files\\Audionaut` on Windows, `audionaut` from\nthe `.deb` or an `Audionaut*.AppImage` in `~/Applications` or `~/.local/bin`\non Linux. Anywhere else, point `AUDIONAUT_CLI` at the binary, e.g. your\nAppImage.\n\n`separate_stems` needs the Demucs model, which you download once in the app\n(Settings ▸ Separation). The model weights are licensed for research use.\n\nA stem split takes minutes for a full song, and exporting or analysing a long\nproject can too. When your client sends a `progressToken` with the call,\n`separate_stems`, `export_audio` and `analyze` report progress (Audionaut\n1.6.5 and later). A call is only stopped after ten minutes without any sign of\nlife, not ten minutes in total.\n\n## Projects that are open in Audionaut\n\nThe tools do not need the user to save first, and they will not write over a\ndocument the user has open. When Audionaut is holding the project, the CLI\nhands the command to the app: it acts on the document as the user currently\nsees it, unsaved changes included, and the result lands in their undo history\nas one step instead of touching `Project.json`. Saving stays theirs to do.\n\nWith no app holding the project, the tools read and write the project file as\nthey always have. If an app is holding one but cannot be reached, the command\nfails (`host_unavailable`) rather than falling back to the file, which would\nbe missing whatever is unsaved.\n\n`Autosave.json` and `Host.json` inside a package belong to the app — never\nread or edit them.\n\n## Tools\n\n| Tool | Wraps | Purpose |\n|---|---|---|\n| `get_project_info` | `info` | Tempo, tracks, clips, files (or the raw persistence JSON) |\n| `create_project` | `create` | New empty `.audium` package |\n| `import_audio` | `import` | Add audio files (creates a new track) |\n| `export_audio` | `export` | Offline render to WAV, FLAC, AIFF, Ogg Vorbis or MP3 |\n| `analyze` | `analyze` | Segment, beat and onset analysis, cached next to the project |\n| `auto_edit` | `auto-edit` | Segment a clip using cached analysis |\n| `assemble` | `assemble` | Build an arrangement from regions |\n| `split` | `split` | Split clips at a timeline position (bars/beats/seconds/clocks) |\n| `create_region` | `create-region` | Create a named region from a timeline range |\n| `set_region` | `set-region` | Rename and/or retrim a region (affects all its clips) |\n| `remove_clip` | `remove-clip` | Remove clip(s) from the timeline |\n| `move_clip` | `move-clip` | Move one clip to a new position and/or another track |\n| `place_clip` | `place-clip` | Place an existing region on the timeline |\n| `cleanup_regions` | `cleanup-regions` | Delete every region no clip uses |\n| `clip_gain` | `clip-gain` | Set a clip's gain (linear or dB, all channels or one) |\n| `clip_fades` | `clip-fades` | Set a clip's fade lengths, offsets and curves |\n| `clip_speed` | `clip-speed` | Set a clip's speed and mode (varispeed or pitch-preserving stretch), or lock it to the project tempo |\n| `remove_track` | `remove-track` | Remove a whole track (channels, clips and regions) |\n| `remove_channel` | `remove-channel` | Remove one channel from a track |\n| `track_pan` | `track-pan` | Pan a track's channel strips, -1 left to 1 right (all strips or one) |\n| `request_feature` | — | Send a feature request to the maintainer (see below) |\n| `report_bug` | — | Send a bug report to the maintainer (see below) |\n| `separate_stems` | `separate` | Split a clip into Drums/Bass/Other/Vocals tracks (Demucs; needs the downloaded model) |\n\nA typical agent flow: `create_project` → `import_audio` → `analyze` →\n`auto_edit`/`assemble` → `export_audio`. CLI errors come back as tool errors\ncarrying the CLI's own `code: message` (e.g. `demucs_unavailable: ...` in\nbuilds without stem separation), so agents can react.\n\n## Feature requests and bug reports from agents\n\nAgents run into the edges of what the tools expose, and into their bugs,\nlong before a person would file an issue, so two tools give them a direct\nchannel. `request_feature` takes a title, a description and (ideally) what\nthe agent was trying to do and which tool fell short. `report_bug` takes\nthe same plus steps to reproduce, the expected behaviour and the project\nshape; its description tells agents to quote the exact tool call and error\ntext and never to attach audio. The server's instructions point agents at\nthe right one whenever a task needs something the tools cannot do or a tool\nmisbehaves, and tell them to say so to the user. A `reporter` name or e-mail\nis included only when the user offers one. Both become GitHub issues -\n`enhancement` + `agent-request` for features, `bug` + `agent-report` for\nbugs; the reply carries the issue URL and the\n[feature-request discussion](https://github.com/kvoltmer/Audionaut/discussions/63).\n\nTransports, tried in order:\n\n1. **Relay** — the default: a deployment of\n   [`Tools/feature-request-relay`](../feature-request-relay/README.md), a\n   Cloudflare Worker that files the issue with its own GitHub token. This is\n   the path for end users, who have no GitHub credentials on the agent side.\n   `AUDIONAUT_FEATURE_REQUEST_URL` points at another deployment; an empty\n   value skips the relay.\n2. **GitHub CLI** — when the relay is skipped and `gh` is installed and\n   logged in, the issue is filed with `gh issue create` under the user's own\n   account (developer machines).\n3. **Nothing** — otherwise the reply says `sent: false` and carries a\n   prefilled new-issue URL for the user to open themselves.\n\n`AUDIONAUT_DISABLE_FEATURE_REQUESTS=1` skips the first two for both tools\n(test harnesses, air-gapped setups); the smoke test points the relay URL at\na local stand-in.\n\n## Environment variables\n\n| Variable | Effect |\n|---|---|\n| `AUDIONAUT_CLI` | Binary that runs the commands: an Audionaut app or `audionaut-cli` |\n| `AUDIONAUT_SKIP_PATH_CHECK` | `1` skips the `~/Music` pre-check for the sandboxed macOS app |\n| `AUDIONAUT_DISABLE_ANALYTICS` | `1` never sends usage analytics, whatever the app's consent setting |\n| `AUDIONAUT_FEATURE_REQUEST_URL` | Issue relay for `request_feature`/`report_bug`; empty skips it |\n| `AUDIONAUT_DISABLE_FEATURE_REQUESTS` | `1` never files issues; replies carry a prefilled link instead |\n\nThe server sets two variables for every Audionaut it runs, which the open\napp uses to group an agent's edits into undo steps: `AUDIONAUT_AGENT_SESSION`\n(one id per server process) and `AUDIONAUT_AGENT_TASK` (the editing tool's\n`task` parameter). Edits with the same session and task share one undo step\nin the user's app, and edits that name no task share one step per session; a\nuser edit, an undo or ten idle minutes start a new one.\n\n## Developing: building the CLI from source\n\nFrom a clone of the repo, the server prefers a CMake build of the\nstandalone `audionaut-cli`, which is not sandboxed:\n\n1. Build the CLI (from the repo root):\n\n   ```\n   cmake -B build -S Audionaut/Catch2Tests\n   cmake --build build -j8 --target AudionautCli\n   ```\n\n2. Install the server's dependencies:\n\n   ```\n   cd Tools/audionaut-mcp && npm install\n   ```\n\n3. Register the checkout instead of the npm package. Claude Code:\n\n   ```\n   claude mcp add audionaut -- node /path/to/Audionaut/Tools/audionaut-mcp/index.js\n   ```\n\n   Claude Desktop: the JSON above with `\"command\": \"node\"` and\n   `\"args\": [\"/path/to/Audionaut/Tools/audionaut-mcp/index.js\"]`.\n\n`npm test` drives the server through a real MCP client against whichever\nbinary it finds (`AUDIONAUT_CLI` picks one). With the sandboxed macOS app it\nworks in a scratch folder under `~/Music`; `AUDIONAUT_TEST_DIR` overrides\nthe location.\n\nPaths in tool arguments are best given absolute — relative paths resolve\nagainst the server process's working directory, which depends on the MCP\nclient.\n","readmeFilename":"README.md"}