MCPcopy
hub / github.com/breaking-brake/cc-wf-studio

github.com/breaking-brake/cc-wf-studio @3.35.1 sqlite

repository ↗ · DeepWiki ↗ · release 3.35.1 ↗
1,910 symbols 4,569 edges 305 files 351 documented · 18%
README

CC Workflow Studio Icon

CC Workflow Studio

GitHub Stars VS Code Marketplace OpenVSX npm @cc-wf-studio/cli npm @cc-wf-studio/mcp Ask DeepWiki

CC Workflow Studio

You think visually. AI thinks in .md. CC Workflow Studio speaks both.

Design workflows on a canvas. Export as Markdown your AI agent already understands. No more prompt-guessing.

Learn more: Why CC Workflow Studio?

Why CC Workflow Studio? - Speaker Deck Link


Supported Agents

Agent Export Format Requires
Claude Code .claude/agents/ .claude/commands/ Claude Code
GitHub Copilot Chat .github/prompts/ Copilot Chat
GitHub Copilot CLI .github/skills/ Copilot CLI
OpenAI Codex CLI .codex/skills/ Codex CLI
Zoo Code (formerly Roo Code) .roo/skills/ Zoo Code
Gemini CLI .gemini/skills/ Gemini CLI
Antigravity .agent/skills/ Antigravity
Cursor .cursor/agents/ .cursor/skills/ Cursor

Note: Agents other than Claude Code require activation from Toolbar's More menu.


Use it without VSCode, too

The VSCode extension is the most ergonomic editor, but it isn't the only entry point. The same workflow.json drives a CLI and an MCP server — pick whichever interface fits the situation.

flowchart LR
    Wf(["workflow.json"])

    subgraph IDE["🪟 VSCode Extension"]
        Canvas["React Flow canvas

+ editor + Slack share"]
    end

    subgraph Mcp["🔌 MCP Server"]
        AIClient["Claude Code,

MCP Inspector, ..."]
        McpServer["@cc-wf-studio/mcp

(stdio: <code>ccwf-mcp</code>)"]
        AIClient --> McpServer
    end

    subgraph Cli["💻 CLI"]
        CliBin["@cc-wf-studio/cli

(<code>ccwf render | validate | export | run | preview | canvas | mcp</code>)"]
    end

    Wf <-->|edit| Canvas
    Wf <-->|read / write| McpServer
    Wf <-->|read / write| CliBin

    Canvas -.->|writes skills + agents| Output["Agent skills on disk

(.claude/, .codex/, .cursor/, ...)"]
    McpServer -.-> Output
    CliBin -.-> Output
Interface Try it Best for Docs
VSCode extension code --install-extension breaking-brake.cc-wf-studio Designing workflows visually packages/vscode
CLI (ccwf) npx @cc-wf-studio/cli --help Terminal / CI / SSH / Codespaces — render, validate, preview, export, run a workflow without VSCode packages/cli
MCP server (ccwf-mcp) Add to your MCP client's .mcp.json so Claude Code (or any MCP client) can read and edit workflows over stdio Letting an external AI client read and edit your workflows through MCP tools packages/mcp

There is no "VSCode-only" path: a workflow you draw in the canvas is the same file ccwf preview will render in a browser, and the same file an external Claude Code can edit through MCP.


AI-Assisted Workflow Creation Demo - MCP Server-based Editing

✨ Edit with AI: AI agents (Claude Code, GitHub Copilot, etc.) create workflows through natural language via MCP Server


Run Workflow Demo - Execute workflows directly from the editor

▶️ Run workflows directly from the editor – See your AI automation in action instantly


Key Features

🔀 Visual Workflow Editor - Intuitive drag-and-drop canvas for designing AI agent orchestrations without code

🤖 Agentic Engineering - Design multi-agent workflows with Sub-Agent orchestration, Agent Skills, and MCP tool integration — the building blocks of agentic engineering

Edit with AI - Iteratively improve workflows through conversational AI - ask for changes, add features, or refine logic with natural language feedback

One-Click Export & Run - Export workflows to ready-to-use formats and run directly from the editor

How to Use

Launch the Extension

  • Click the icon icon in the top-right corner of the editor
  • Or: Command Palette (Cmd+Shift+P) → "CC Workflow Studio: Open Editor"

Create a Workflow

  • Add nodes from the palette and configure their settings, or use Edit with AI.

Save & Load

  • Click Save save button in the toolbar to store your workflow as .vscode/workflows/*.json
  • Click Load load button in the toolbar to open a saved .json workflow

Export & Run

  • Click Export export button in the toolbar to create a .md slash command or agent skill (use /workflow-name in AI coding agents)
  • Click Run run button in the toolbar to run your workflow directly in AI coding agents

Edit with AI

  • Click Edit with AI sparkles button in the toolbar to generate or refine workflows with natural language
  • Native with MCP Server: Click an AI agent button in the Edit with AI panel to launch native AI editing. The MCP server starts automatically behind the scenes.
sequenceDiagram
    actor User
    box VS Code (CC Workflow Studio)
        participant UI as Editor UI
        participant MCP as MCP Server
    end
    participant Agent as AI Agent

    User->>UI: Click agent button
    UI->>MCP: Auto start server
    UI->>Agent: Launch with editing skill

    loop AI edits workflow
        Agent->>MCP: get_workflow
        MCP-->>Agent: workflow JSON
        Agent->>MCP: apply_workflow
        MCP->>UI: Update canvas
    end

Usage Examples

Coming soon - Sample workflows and tutorials are under development.

License

The VSCode extension (cc-wf-studio) is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-or-later).

See the LICENSE file for the full license text.

The reusable libraries published to npm — @cc-wf-studio/core, @cc-wf-studio/mcp, and @cc-wf-studio/cli — are released under the more permissive MIT license. Each package ships its own LICENSE file, which takes precedence for that package.

Copyright (c) 2025 breaking-brake

Star History

Star History Chart

Acknowledgments

Built with React Flow • Powered by Claude Code • Inspired by Dify


Made with CC Workflow Studio

Extension points exported contracts — how you extend this code

WorkflowIoAdapter (Interface)
(no doc) [4 implementers]
packages/mcp/src/types.ts
PropertyOverlayProps (Interface)
* PropertyOverlay Props
packages/vscode/src/webview/src/components/PropertyOverlay.tsx
Position (Interface)
(no doc)
packages/core/src/types/workflow-definition.ts
InitialStatePayload (Interface)
(no doc)
packages/cli/src/canvas/handlers.ts
FileWorkflowAdapterOptions (Interface)
(no doc)
packages/mcp/src/file-adapter.ts
NodePaletteProps (Interface)
* NodePalette Component Props
packages/vscode/src/webview/src/components/NodePalette.tsx
WorkflowMetadata (Interface)
(no doc)
packages/core/src/types/workflow-definition.ts
LoadWorkflowPayload (Interface)
(no doc)
packages/cli/src/canvas/handlers.ts

Core symbols most depended-on inside this repo

log
called by 466
packages/vscode/src/extension/extension.ts
postMessage
called by 371
packages/vscode/src/webview/src/services/vscode-api.ts
map
called by 278
packages/vscode/src/extension/services/mcp-server-service.ts
useTranslation
called by 75
packages/vscode/src/webview/src/i18n/i18n-context.tsx
getState
called by 60
packages/vscode/src/webview/src/services/vscode-api.ts
readFile
called by 47
packages/vscode/src/extension/services/file-service.ts
openExternalUrl
called by 39
packages/vscode/src/webview/src/services/vscode-bridge.ts
setState
called by 32
packages/vscode/src/webview/src/overview-polyfill.ts

Shape

Function 1,141
Interface 585
Method 141
Class 38
Enum 5

Languages

TypeScript100%

Modules by API surface

packages/vscode/src/shared/types/messages.ts192 symbols
packages/vscode/src/webview/src/services/vscode-bridge.ts44 symbols
packages/core/src/types/workflow-definition.ts44 symbols
packages/vscode/src/extension/utils/path-utils.ts31 symbols
packages/vscode/src/webview/src/services/slack-integration-service.ts30 symbols
packages/vscode/src/webview/src/components/dialogs/ClaudeApiUploadDialog.tsx29 symbols
packages/vscode/src/webview/src/stores/refinement-store.ts28 symbols
packages/core/src/services/workflow-overview-formatter.ts28 symbols
packages/vscode/src/webview/src/components/PropertyOverlay.tsx25 symbols
packages/vscode/src/extension/services/mcp-server-service.ts25 symbols
packages/vscode/src/extension/utils/slack-token-manager.ts23 symbols
packages/vscode/src/webview/src/components/Toolbar.tsx22 symbols

Dependencies from manifests, versioned

@biomejs/biome2.4.4 · 1×
@cc-wf-studio/cliworkspace:* · 1×
@cc-wf-studio/coreworkspace:* · 1×
@cc-wf-studio/mcpworkspace:* · 1×
@changesets/cli2.31.0 · 1×
@modelcontextprotocol/sdk1.26.0 · 1×
@radix-ui/react-collapsible1.1.12 · 1×
@radix-ui/react-dialog1.1.15 · 1×
@radix-ui/react-dropdown-menu2.1.16 · 1×
@radix-ui/react-popover1.1.15 · 1×
@radix-ui/react-switch1.2.6 · 1×

For agents

$ claude mcp add cc-wf-studio \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact