claude-workflow

KO | EN

gitlite — search

#python #hacktoberfest #react #typescript #android #machine-learning #deep-learning #nodejs #macos #windows #kubernetes #pytorch #mcp #open-source

claude-workflow

(★ 17)

Automated Claude Code configuration setup for existing projects

claude-workflow Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# claude-workflow

Multi-agent orchestration CLI for [Claude Code](https://claude.ai/code). Define workflows in YAML, spawn 54 specialized AI agents, and monitor everything in real time.

**[Website](https://claudeworkflow.com)** | **[GitHub](https://github.com/fullstacktard/claude-workflow)**

## Install

```bash
npm install -g claude-workflow
```

Requires Node.js >= 18.

## What You Get

- **54 specialized agents** -- frontend, backend, DevOps, QA, design, 3D, and more
- **YAML workflows** -- define multi-step pipelines that chain agents together
- **Real-time dashboard** -- monitor agents, logs, and tasks in a web UI
- **MCP proxy** -- unified access to MCP tool servers (3 free, 15+ pro, 25+ all) through one connection
- **Auto-spawning** -- agents automatically decompose tasks and spawn sub-agents in parallel
- **Pro module system** -- unlock additional agents, workflows, and capabilities

## Quick Start

```bash
# 1. Install globally
npm install -g claude-workflow

# 2. Scaffold a project
claude-workflow init

# 3. Start Docker services (dashboard, proxy, MCP)
docker compose -f .claude/docker-compose.yml up -d

# 4. Create a workflow brief
claude-workflow draft "user authentication"

# 5. Hand the brief to Claude Code
# Paste @backlog/workflows/user-authentication/brief.md in Claude Code
```

## Commands

### Project Setup

```bash
claude-workflow init                    # Scaffold .claude/, Docker, agents, workflows
claude-workflow init --tailwind         # Enable Tailwind CSS v4 mode
claude-workflow update                  # Update templates without overwriting CLAUDE.md
claude-workflow update --force          # Force overwrite existing files
claude-workflow uninstall               # Remove from project registry
```

### Workflows

```bash
claude-workflow draft "my feature"           # Create a feature brief
claude-workflow draft "nav" --type ui        # UI generation brief
claude-workflow draft "api" --type qa        # QA testing brief
claude-workflow draft "cleanup" --type lint  # Lint fix brief
claude-workflow draft "walkthrough" --type demo  # Demo video brief
```

Brief types: `feature` (default), `qa`, `ui`, `lint`, `demo`, `surreal`, `redesign`, `setup`.

### Pro License

```bash
claude-workflow activate <key>          # Activate a license key
claude-workflow activate --refresh      # Refresh license JWT
claude-workflow activate --sync         # Download/update pro modules
claude-workflow activate --deactivate   # Remove license, revert to free
claude-workflow activate --status       # Show license status

claude-workflow pro status              # Detailed pro tier info
claude-workflow pro update              # Check for pro module updates
claude-workflow features list           # List all features by tier
```

### Utilities

```bash
claude-workflow generate-agent-hashes   # Regenerate agent hash registry
```

## Project Structure

```
your-project/
  .claude/
    agents/          # Agent definitions (markdown)
    hooks/           # Pre/post tool-use hooks
    skills/          # Reusable skill modules
    schemas/         # JSON schemas for validation
    workflows/       # YAML workflow definitions
    commands/        # CLI slash commands
    docker-compose.yml
  backlog/           # Task management
  CLAUDE.md          # Project instructions for Claude Code
```

## Docker Services

| Service | Port | Description |
|---------|------|-------------|
| Dashboard | 3850 | Real-time agent visualization, logs, account management |
| Claude Proxy | 4000 | LiteLLM-based model routing and account rotation |
| MCP Proxy | 3100 | Multiplexes 50+ MCP tool servers behind one endpoint |

## Packages

This monorepo contains 30 packages organized by domain.

### Core

| Package | Description |
|---------|-------------|
| `claude-workflow` | Multi-agent workflow orchestration CLI for Claude Code |
| `mcp-proxy` | MCP server aggregator proxy for Claude Code workflow |
| `claude-proxy` | LiteLLM proxy with per-agent model routing and OAuth token injection |

### Content & Media

| Package | Description |
|---------|-------------|
| `remotion-mcp` | MCP server for Remotion video composition and rendering |
| `video-generation-mcp` | MCP server for video generation APIs (Runway, Pika, Luma, etc.) |
| `elevenlabs-mcp` | MCP server for ElevenLabs Text-to-Speech API |
| `youtube-dl-mcp` | MCP server for downloading YouTube audio via yt-dlp |
| `banner-tools` | CLI tool for banner text rendering and image compositing |
| `music-generation-mcp` | MCP server for AI music generation via AIMusicAPI.ai |

### Presentations

| Package | Description |
|---------|-------------|
| `gamma-mcp` | MCP server for Gamma.app AI presentation generation |
| `presenton-mcp` | MCP server for Presenton AI presentation generation |
| `slidespeak-mcp` | MCP server for SlideSpeak AI presentation generation |

### X/Twitter

| Package | Description |
|---------|-------------|
| `x-shared` | Shared types, database, vault, and character validation for X-domain MCP servers |
| `x-persona-mcp` | MCP server for AI persona management and tweet generation via Claude API |
| `x-premium-mcp` | MCP server for X Premium subscription management |
| `x-research-mcp` | MCP server for X/Twitter research: tweet search, trend detection, engagement analysis |

### Account Automation

| Package | Description |
|---------|-------------|
| `geelark-mcp` | MCP server for GeeLark cloud phone automation -- X account creation via cloud Android devices |
| `email-provisioner-mcp` | MCP server for creating Mail.com/GMX email accounts via browser automation |

### Domain

| Package | Description |
|---------|-------------|
| `domain-availability-mcp` | MCP server for domain availability, multi-registrar pricing, parking detection, and auction search |
| `mcp-domain-purchaser` | MCP server for domain purchase across multiple registrars |

### Other

| Package | Description |
|---------|-------------|
| `meshy-mcp` | MCP server for Meshy AI auto-rigging and animation API |
| `v0-mcp` | MCP server for v0 AI UI generation |
| `solana-mcp` | MCP server wrapping Solana CLI for on-chain queries |
| `marketing-mcp` | MCP server for AI-powered marketing tools -- competitor tracking, tweet scraping, content analysis |
| `tmux-manager` | TUI application for managing tmux sessions grouped by claude-workflow projects |

## Pricing

| | Free | Pro | All |
|---|---|---|---|
| **Price** | $0 | $20/mo | $29/mo |
| **Agents** | 12 core agents | 48 agents | 54 agents |
| **Workflows** | Core workflow | All workflows | All workflows |
| **Dashboard** | -- | Real-time dashboard | Real-time dashboard |
| **Claude Proxy** | -- | Model routing | Model routing |
| **MCP Proxy** | Included | Included | Included |
| **X/Twitter Automation** | -- | -- | 6 agents |
| **3D Rigging/Animation** | -- | -- | 3 agents |

**[Subscribe](https://polar.sh/claude-workflow)** to unlock Pro or All.

## How Workflows Work

1. **Draft** a brief: `claude-workflow draft "my feature"`
2. **Fill in** the generated brief template
3. **Hand it to Claude**: reference `@backlog/workflows/<slug>/brief.md` in Claude Code
4. Claude reads the brief, picks agents, and executes the workflow automatically

## License

MIT

claude-workflow

claude-workflow Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

claude-workflow

claude-workflow Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README