# 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.
Why CC Workflow Studio? - Speaker Deck Link
---
## Supported Agents
| Agent | Export Format | Requires |
|-------|--------------|----------|
| Claude Code | `.claude/agents/` `.claude/commands/` | [Claude Code](https://github.com/anthropics/claude-code) |
| GitHub Copilot Chat | `.github/prompts/` | [Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) |
| GitHub Copilot CLI | `.github/skills/` | [Copilot CLI](https://github.com/github/copilot-cli) |
| OpenAI Codex CLI | `.codex/skills/` | [Codex CLI](https://github.com/openai/codex) |
| Zoo Code (formerly Roo Code) | `.roo/skills/` | [Zoo Code](https://marketplace.visualstudio.com/items?itemName=ZooCodeOrganization.zoo-code) |
| Gemini CLI | `.gemini/skills/` | [Gemini CLI](https://github.com/google-gemini/gemini-cli) |
| Antigravity | `.agent/skills/` | [Antigravity](https://antigravity.google/) |
| Cursor | `.cursor/agents/` `.cursor/skills/` | [Cursor](https://github.com/cursor/cursor) |
> **Note:** Agents other than Claude Code require activation from Toolbar's **More** menu.
---
✨ Edit with AI: AI agents (Claude Code, GitHub Copilot, etc.) create workflows through natural language via MCP Server
---
▶️ 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 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](#edit-with-ai).
### Save & Load
- Click Save
button in the toolbar to store your workflow as `.vscode/workflows/*.json`
- Click Load
button in the toolbar to open a saved `.json` workflow
### Export & Run
- Click Export
button in the toolbar to create a `.md` slash command or agent skill (use `/workflow-name` in AI coding agents)
- Click Run
button in the toolbar to run your workflow directly in AI coding agents
### Edit with AI
- Click Edit with AI
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.
```mermaid
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.
## Use without VSCode
The extension is one of three entry points to the same workflow JSON. Outside VSCode you can drive the canvas through:
- **[`@cc-wf-studio/cli`](https://www.npmjs.com/package/@cc-wf-studio/cli)** — `ccwf preview` opens a read-only browser viewer for any workflow file, `ccwf export` / `ccwf run` materialise it as Agent Skills, `ccwf canvas` runs the full editor in a localhost browser.
- **[`@cc-wf-studio/mcp`](https://www.npmjs.com/package/@cc-wf-studio/mcp)** — the same MCP tools this extension exposes to in-canvas AI editing, available standalone via `npx @cc-wf-studio/mcp --file ` so an external Claude Code (or any MCP client) can read and edit your workflows.
Same `workflow.json`, three interfaces. See the [monorepo README](https://github.com/breaking-brake/cc-wf-studio#readme) for the full story.
## License
This project is licensed under the **GNU Affero General Public License v3.0** (AGPL-3.0-or-later).
See the [LICENSE](./LICENSE) file for the full license text.
### What this means
- You can use, modify, and distribute this software
- If you modify and deploy this software (including as a network service), you must:
- Make your modified source code available under AGPL-3.0
- Provide access to the source code for users interacting with the service
- Commercial use is allowed, but proprietary modifications are not
Copyright (c) 2025 breaking-brake
## Star History
[](https://star-history.com/#breaking-brake/cc-wf-studio&Date)
## Acknowledgments
Built with [React Flow](https://reactflow.dev/) • Powered by [Claude Code](https://claude.com/claude-code) • Inspired by [Dify](https://dify.ai/)
---
**Made with CC Workflow Studio**