Nexus Workflow Studio

A visual workflow editor for designing, composing, and exporting AI agent workflows. Built with Next.js, React Flow, Zustand, and Zod.

Features

• Visual Drag-and-Drop Canvas — design workflows by dragging nodes from the palette onto an infinite canvas
• 11 Node Types — Start, End, Prompt, Agent, Skill, Document, MCP Tool, If-Else, Switch, Ask User, Sub-Workflow
• Sub-Workflows — nest workflows inside sub-workflow nodes with full breadcrumb navigation
• Properties Panel — configure every node via a type-safe form with Zod validation
• Library System — save/load workflows and reusable node configurations to localStorage
• Code Generation — export workflows as .opencode command files with a single click
• Mermaid Preview — visualize workflow structure as a Mermaid diagram
• Auto-Layout — automatic Dagre-based graph layout with smooth animation
• Undo/Redo — full history support via Zundo
• Keyboard Shortcuts — comprehensive shortcut set (? to view all)
• Dark Theme — purpose-built dark UI optimized for extended use

Getting Started

Prerequisites

• Node.js ≥ 18.18
• npm ≥ 9

Installation

git clone https://github.com/anthropics/nexus-workflow-studio.git
cd nexus-workflow-studio
npm install

Development

npm run dev

Open http://localhost:3000 in your browser.

Build

npm run build
npm start

Docker

The project includes Docker support with two runtime options: Bun (default) and Node.js. Both produce the same Next.js standalone output — the difference is the runtime that serves the application.

Default: Bun

A faster runtime using oven/bun. Offers quicker dependency installs and cold starts. Runs by default with docker compose up.

# Using npm script
npm run docker:bun

# Or using Docker Compose directly
docker compose up --build

Alternative: Node.js

The standard, production-proven runtime using node:24-slim. Requires the node profile.

# Using npm script
npm run docker:node

# Or using Docker Compose directly
docker compose --profile node up nextjs-standalone --build

Running in Detached Mode

Append the -d flag to run in the background:

docker compose up --build -d
docker compose --profile node up nextjs-standalone --build -d

Stopping

npm run docker:down
# or
docker compose --profile node down

Once running, open http://localhost:3000 in your browser.

Adding a New Node Type

See CONTRIBUTING.md for the step-by-step guide.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md before submitting a PR.

License

MIT © Nexus Workflow Studio Contributors