Skip to content
Back to search

beatdesign

Official BeatDesign plugins for Claude Code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/beatapi--beatdesign/badge.svg)](/listings/beatapi--beatdesign)

HTML

<a href="/listings/beatapi--beatdesign"><img src="/api/listings/beatapi--beatdesign/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements include Node.js 22+, `pnpm` 10+, and a current Chrome browser on macOS or Windows.

pnpm install
pnpm db:push
pnpm dev

Open [http://127.0.0.1:3020](http://127.0.0.1:3020).

Add your own [BeatAPI API key](https://beatapi.io/dashboard/apikeys) only when you want to generate or analyze media, or use AI redo. Selecting a local file does not upload it to a provider.

Choose how to run BeatDesign

| Command | Starts | | --- | --- | | `pnpm dev` | The visual workspace | | `pnpm dev:agent` | The visual workspace and local HTTP MCP endpoint | | `pnpm mcp` | The stdio MCP server for coding Agents |

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "beatdesign",
  3. "owner": {
  4. "name": "BeatAPI"
  5. },
  6. "description": "Official BeatDesign plugins for Claude Code.",
  7. "version": "0.2.5",
  8. "plugins": [
  9. {
  10. "name": "beatdesign",
  11. "source": "./integrations/claude-code/beatdesign",
  12. "description": "Operate a local BeatDesign Canvas and video Editor through MCP.",
  13. "version": "0.2.5",
  14. "author": {
  15. "name": "BeatAPI"
  16. }
  17. }
  18. ]
  19. }
README.md · README · 167 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="./docs/assets/beatdesign-readme-cover-v3.jpg" alt="BeatDesign infinite Canvas and local video Editor" width="100%" />
  3. </p>
  4. <p align="center">
  5. <a href="https://linux.do" alt="LINUX DO">
  6. <img
  7. src="https://img.shields.io/badge/LINUX-DO-FFB003.svg?logo=data:image/svg%2bxml;base64,DQo8c3ZnIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgd2lkdGg9IjEwMCIgaGVpZ2h0PSIxMDAiPjxwYXRoIGQ9Ik00Ni44Mi0uMDU1aDYuMjVxMjMuOTY5IDIuMDYyIDM4IDIxLjQyNmM1LjI1OCA3LjY3NiA4LjIxNSAxNi4xNTYgOC44NzUgMjUuNDV2Ni4yNXEtMi4wNjQgMjMuOTY4LTIxLjQzIDM4LTExLjUxMiA3Ljg4NS0yNS40NDUgOC44NzRoLTYuMjVxLTIzLjk3LTIuMDY0LTM4LjAwNC0yMS40M1EuOTcxIDY3LjA1Ni0uMDU0IDUzLjE4di02LjQ3M0MxLjM2MiAzMC43ODEgOC41MDMgMTguMTQ4IDIxLjM3IDguODE3IDI5LjA0NyAzLjU2MiAzNy41MjcuNjA0IDQ2LjgyMS0uMDU2IiBzdHlsZT0ic3Ryb2tlOm5vbmU7ZmlsbC1ydWxlOmV2ZW5vZGQ7ZmlsbDojZWNlY2VjO2ZpbGwtb3BhY2l0eToxIi8+PHBhdGggZD0iTTQ3LjI2NiAyLjk1N3EyMi41My0uNjUgMzcuNzc3IDE1LjczOGE0OS43IDQ5LjcgMCAwIDEgNi44NjcgMTAuMTU3cS00MS45NjQuMjIyLTgzLjkzIDAgOS43NS0xOC42MTYgMzAuMDI0LTI0LjM4N2E2MSA2MSAwIDAgMSA5LjI2Mi0xLjUwOCIgc3R5bGU9InN0cm9rZTpub25lO2ZpbGwtcnVsZTpldmVub2RkO2ZpbGw6IzE5MTkxOTtmaWxsLW9wYWNpdHk6MSIvPjxwYXRoIGQ9Ik03Ljk4IDcwLjkyNmMyNy45NzctLjAzNSA1NS45NTQgMCA4My45My4xMTNRODMuNDI2IDg3LjQ3MyA2Ni4xMyA5NC4wODZxLTE4LjgxIDYuNTQ0LTM2LjgzMi0xLjg5OC0xNC4yMDMtNy4wOS0yMS4zMTctMjEuMjYyIiBzdHlsZT0ic3Ryb2tlOm5vbmU7ZmlsbC1ydWxlOmV2ZW5vZGQ7ZmlsbDojZjlhZjAwO2ZpbGwtb3BhY2l0eToxIi8+PC9zdmc+" /></a>
  8. </p>
  9. <h1 align="center">BeatDesign</h1>
  10. <p align="center">
  11. <strong>Your local Higgsfield alternative.</strong><br />
  12. Build image and video workflows on an infinite Canvas, finish them in a browser-native Editor, and let any MCP-capable Agent work in the same Project.
  13. </p>
  14. <p align="center">
  15. <a href="https://beatapi.io/design">Website</a> ·
  16. <a href="#quick-start">Quick start</a> ·
  17. <a href="#use-beatdesign-with-an-agent">MCP</a> ·
  18. <a href="./docs/PRODUCT_PLAN_AND_STATUS.md">Product status</a>
  19. </p>
  20. <p align="center">
  21. <strong>English</strong> ·
  22. <a href="./README.zh-CN.md">简体中文</a> ·
  23. <a href="./README.ja.md">日本語</a>
  24. </p>
  25. BeatDesign is an independent, open-source, local-first workspace for AI image and video creation. It is built for people who want the connected creative flow of tools such as Higgsfield, with a workspace they can run, inspect, and extend on their own machine.
  26. ## Latest release — v0.2.5 · October 2026
  27. Available in [GitHub Release v0.2.5](https://github.com/BeatAPI/BeatDesign/releases/tag/v0.2.5) and `@beatapi/beatdesign-workbuddy@0.2.5`. WorkBuddy marketplace review and availability are tracked separately.
  28. For an existing source checkout, stop BeatDesign, run `git pull --ff-only`, `pnpm install --frozen-lockfile`, `pnpm db:push`, then restart `pnpm dev:agent` (or your usual UI/MCP commands). Keep your local data directory; no reinstall or project reset is needed.
  29. - **Project settings:** edit names and descriptions, upload or select a cover, and reset to an automatic image or local video poster. A manual cover stays selected after later imports and generations. Open the settings icon on a project card or workspace header.
  30. - **Consistent generation versions:** Canvas previews and Take selection agree on the latest successful output; manual selections and concrete timeline Assets are preserved.
  31. - **Faster project entry:** choosing Canvas or Studio creates one project and opens it directly, with retry protection.
  32. - **Reliable audio export:** MCP timeline rendering preserves clip gain across sequential shots, with peak protection for overlapping audio.
  33. - **30 MCP tools:** Agents can update project settings through the same revision-checked command path as the UI. Canvas undo/redo can save an intentionally empty canvas; Windows test portability and narrow-screen layout are improved.
  34. Already available: tail-frame continuation, Canvas-to-Editor handoff, image overlays, styled SRT captions, browser-native MP4 export, and MCP timeline rendering. Browser export needs no system FFmpeg; MCP frame extraction needs `ffmpeg`, and MCP timeline rendering also needs `ffprobe`.
  35. [Change details](./CHANGELOG.md) · [Project settings](./docs/PROJECT_SETTINGS.md) · [Current scope and roadmap](./docs/PRODUCT_PLAN_AND_STATUS.md)
  36. Current source (unreleased) adds persistent Canvas groups and arrangement, Asset folders, exact-version Elements and reusable local workflow templates, with 38 MCP tools. These changes are not in the v0.2.5 npm package. [Organization guide](./docs/PROJECT_ORGANIZATION.md).
  37. ## Two creative modes, one Project
  38. ### Infinite Canvas
  39. Drop in prompts, images, video, and audio. Connect nodes, branch ideas, compare generations, reuse outputs, and keep the full visual workflow inside one project.
  40. ### Video Editor
  41. Turn Canvas results into a local timeline. Trim, split, move, mix audio, place and transform image overlays, style SRT captions, create alternate AI Takes, preview, and export MP4 in the browser.
  42. Studio provides a focused generation surface. Assets keeps every imported and generated file available across Canvas, Editor, and MCP.
  43. ## Why BeatDesign
  44. - **Local by default.** Projects, media, Canvas state, timelines, and generation history stay in your local workspace.
  45. - **Canvas and Editor stay connected.** A generated result becomes a reusable project Asset instead of disappearing inside one tool.
  46. - **Bring your own Agent.** Codex, Claude Code, Cursor, and other MCP hosts can inspect and update the same Project you see in the browser.
  47. - **Bring your own generation access.** BeatAPI is the built-in provider. Local importing, arranging, editing, previewing, and exporting do not require an API key.
  48. - **Fork-friendly foundations.** Provider adapters, project storage, and the command layer are explicit extension points.
  49. ## From idea to finished video
  50. ```text
  51. Prompt or local media
  52. ↓
  53. Infinite Canvas ─── connect, generate, branch, compare
  54. ↓
  55. Shared Assets ───── images, video, audio, extracted clips
  56. ↓
  57. Video Editor ────── trim, arrange, preview, export MP4
  58. ↑
  59. Any MCP Agent ───── works in the same local Project
  60. ```
  61. ## Quick start
  62. Requirements include Node.js 22+, `pnpm` 10+, and a current Chrome browser on macOS or Windows.
  63. ```bash
  64. git clone https://github.com/BeatAPI/BeatDesign.git
  65. cd BeatDesign
  66. pnpm install
  67. pnpm db:push
  68. pnpm dev
  69. ```
  70. Open [http://127.0.0.1:3020](http://127.0.0.1:3020).
  71. Use the language menu to choose English, Chinese, or Japanese. Current source remembers the choice in this browser for 400 days, renewed on each visit, including when reopening an old localized link. Use the same local hostname; another browser, private session, or cleared site data needs a new choice.
  72. Add your own [BeatAPI API key](https://beatapi.io/dashboard/apikeys) only when you want to generate or analyze media, or use AI redo. Selecting a local file does not upload it to a provider.
  73. ### Choose how to run BeatDesign
  74. | Command | Starts |
  75. | --- | --- |
  76. | `pnpm dev` | The visual workspace |
  77. | `pnpm dev:agent` | The visual workspace and local HTTP MCP endpoint |
  78. | `pnpm mcp` | The stdio MCP server for coding Agents |
  79. ## Use BeatDesign with an Agent
  80. Current source exposes 38 local MCP tools (v0.2.5 packages expose 30) for Skills, Projects, Assets, Canvas, generation, and Editor operations, including built-in Skill discovery and authoritative MP4 timeline rendering. Agent changes use the same project services and become visible in the browser workspace.
  81. After connecting your MCP host, you can ask:
  82. > Open my latest BeatDesign project, add these clips to a timeline, place the logo overlay, adjust the subtitles, and leave the Editor open for review.
  83. ## Platform compatibility
  84. | Coding Agent / platform | Status | Quick setup |
  85. | --- | --- | --- |
  86. | [Claude Code](./integrations/claude-code/beatdesign/README.md) | ✅ Supported | [Plugin or MCP config](./integrations/claude-code/) |
  87. | [Codex](./integrations/codex/beatdesign/README.md) | ✅ Supported | [Plugin setup](./integrations/codex/beatdesign/README.md) |
  88. | [ZCode](./integrations/zcode/config.example.json) | ✅ Supported | [MCP config](./integrations/zcode/config.example.json) |
  89. | [OpenCode](./integrations/opencode/) | ✅ Supported | [MCP config](./integrations/opencode/) |
  90. | [Cursor](./integrations/cursor/mcp.json.example) | ✅ Supported | [MCP config](./integrations/cursor/mcp.json.example) |
  91. | [Windsurf](./integrations/windsurf/mcp_config.json.example) | ✅ Supported | [MCP config](./integrations/windsurf/mcp_config.json.example) |
  92. | [VS Code + GitHub Copilot](./integrations/vscode/mcp.json.example) | ✅ Supported | [MCP config](./integrations/vscode/mcp.json.example) |
  93. | [Cline / Roo Code](./integrations/cline/mcp_settings.json.example) | ✅ Supported | [MCP config](./integrations/cline/mcp_settings.json.example) |
  94. | [Qwen Code](./integrations/qwen/settings.example.json) | ✅ Supported | [MCP config](./integrations/qwen/settings.example.json) |
  95. | [Gemini CLI](./integrations/gemini/settings.example.json) | ✅ Supported | [MCP config](./integrations/gemini/settings.example.json) |
  96. | [Hermes Agent](./integrations/hermes/config.yaml.snippet) | ✅ Supported | [MCP config](./integrations/hermes/config.yaml.snippet) |
  97. | [Kiro](./integrations/kiro/mcp.json.example) | ✅ Supported | [MCP config](./integrations/kiro/mcp.json.example) |
  98. | [Trae](./integrations/trae/mcp.json.example) | ✅ Supported | [MCP config](./integrations/trae/mcp.json.example) |
  99. | [WorkBuddy](./integrations/workbuddy/beatdesign/README.md) | ✅ Supported | [Connector setup](./integrations/workbuddy/beatdesign/README.md) |
  100. | [QwenWork](./integrations/qwenwork/mcp.json.example) | ✅ Supported | [HTTP connector](./integrations/qwenwork/mcp.json.example) |
  101. | [Doubao Work](./integrations/doubao-work/mcp.json.example) | ✅ Supported | [HTTP connector](./integrations/doubao-work/mcp.json.example) |
  102. [Open the full Agent integration guide →](./integrations/README.md)
  103. ## What works today
  104. - Image and video generation plus Standard and Deep video analysis.
  105. - Image, video, audio, generation, timeline, and text nodes on the Canvas.
  106. - Project Assets shared across Studio, Canvas, Editor, and MCP.
  107. - Non-destructive timeline editing with image, video, audio, movable image overlays, and styled SRT caption tracks.
  108. - Local preview and browser-side H.264/AAC MP4 export with WebCodecs and Mediabunny.
  109. - English, Chinese, and Japanese interfaces.
  110. - Local stdio and Streamable HTTP MCP transports.
  111. BeatDesign currently focuses on local, short-form creative workflows. Hosted collaboration, multiple named timelines, advanced transitions, speed controls, waveforms, and desktop packaging remain outside the current release.
  112. [See the complete shipped and planned scope →](./docs/PRODUCT_PLAN_AND_STATUS.md)
  113. ## Project guides
  114. - [Product status](./docs/PRODUCT_PLAN_AND_STATUS.md)
  115. - [MCP setup](./docs/MCP.md)
  116. - [Architecture](./docs/ARCHITECTURE.md)
  117. - [Provider integration](./docs/PROVIDERS.md)
  118. - [Contributing](./.github/CONTRIBUTING.md)
  119. - [Security](./.github/SECURITY.md)
  120. ## License
  121. BeatDesign is licensed under [Apache License 2.0](./LICENSE). BeatAPI and BeatDesign trademarks, third-party model access, and bundled third-party components remain subject to their respective terms. See [third-party notices](./third_party/) and [trademark policy](./docs/TRADEMARKS.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.