Orchestro - Trello for Claude Code

by khaoss85

16 326 downloads Not rated yet

About

Transform product ideas into reality with an intelligent orchestration system that bridges Product Managers, Developers, and AI. Orchestro conducts the entire development symphony: task decomposition, dependency tracking, pattern learning, and real-time progress visualization.

Explore

- 60 MCP tools for orchestrated development
- AI-powered user story decomposition into technical tasks
- Visual Kanban board with real-time progress updates
- Dependency graphs and conflict detection across tasks
- Pattern learning from past implementations (success/failure)
- Context retention between Claude Code sessions
- Rollback capability and complete audit timeline

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Orchestro - Trello for Claude Code
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- QUICK_START.md - 5-minute setup guide
- PM_GUIDE.md - For Product Managers (Coming Soon)
- DEV_GUIDE.md - For Developers (Coming Soon)
- EXAMPLES.md - Real-world usage examples

npx @khaoss85/orchestro@latest


Or add to Claude Code config:
json
{
"mcpServers": {
"orchestro": {
"command": "npx",
"args": ["-y", "@khaoss85/orchestro@latest"],
"env": {
"DATABASE_URL": "your-supabase-connection-string"
}
}
}
}

---

bash
npx @orchestro/init

That's it! The installer will:
- ✅ Download and setup Orchestro
- ✅ Apply database migrations to Supabase
- ✅ Configure Claude Code automatically
- ✅ Setup Supabase connection
- ✅ Start the dashboard
- ✅ Verify everything works

Interactive prompts:


🎭 Orchestro Setup Wizard

? Supabase connection string: ████████
? Project name: My Project
? Install location: ~/orchestro

⚙️ Setting up...
✓ Orchestro installed
✓ Claude Code configured
✓ Database ready

🎉 Done! Restart Claude Code and ask:
"Show me orchestro tools"


---

bash

Create your Supabase project:
1. Go to https://supabase.com and create a new project
2. Wait for the database to be provisioned (~2 minutes)
3. Go to Settings → Database and copy the Connection String (Transaction mode)

Apply database schema:


npm install

bash

npm run setup

cat > .env << EOF
DATABASE_URL=your-supabase-connection-string
SUPABASE_URL=your-supabase-url
SUPABASE_SERVICE_KEY=your-service-key
EOF


bash

npm run configure-claude


claude mcp add orchestro

See Integration Guide for existing project setup.

---

/plugin install orchestro-suite@orchestro-marketplace

Tech Stack:
- add_tech_stack - Add framework/library
- update_tech_stack - Update version/config
- remove_tech_stack - Remove technology

Sub-Agents (Guardians):
- add_sub_agent - Register guardian agent
- update_sub_agent - Modify agent config
- sync_claude_code_agents - Sync from .claude/agents/
- read_claude_code_agents - Read agent files
- suggest_agents_for_task - AI-powered agent recommendations
- update_agent_prompt_templates - Update prompt templates

MCP Tools Management:
- add_mcp_tool - Register MCP tool
- update_mcp_tool - Update tool config
- suggest_tools_for_task - AI-powered tool recommendations

Guidelines & Patterns:
- add_guideline - Add coding guideline
- add_code_pattern - Add reusable pattern

get_project_info

Project metadata and status

get_project_configuration

Complete project configuration

initialize_project_configuration

Setup default tools and guardians

create_task

Create with assignee, priority, tags, category

list_tasks

Filter by status/category/tags

update_task

Modify any field with validation

delete_task

Safe deletion with dependency checks

get_task_context

Full context with dependencies (deprecated, use prepare_task_for_execution)

get_execution_order

Topological sort by dependencies

safe_delete_tasks_by_status

Bulk delete with safety checks

prepare_task_for_execution

Generate codebase analysis prompt

save_task_analysis

Store analysis results

get_execution_prompt

Enriched implementation context

decompose_story

AI-powered story → tasks decomposition with automatic analysis (autoAnalyze=true default)

get_user_stories

List all user stories

get_tasks_by_user_story

Get all child tasks

get_user_story_health

Monitor story completion status

save_dependencies

Record task resource dependencies

get_task_dependency_graph

Visualize dependency graph

get_resource_usage

Find tasks using a resource

get_task_conflicts

Detect conflicting resource usage

list_templates

Available prompt/code templates

list_patterns

Coding patterns library

list_learnings

Past experience records

render_template

Generate from template with variables

get_relevant_knowledge

Context-aware suggestions

add_feedback

Record success/failure/improvement

get_similar_learnings

Find related experiences

get_top_patterns

Most frequently used patterns

get_trending_patterns

Recently popular patterns

get_pattern_stats

Detailed pattern metrics

detect_failure_patterns

Auto-detect risky approaches

check_pattern_risk

Risk assessment before using pattern

add_tech_stack

Add framework/library

update_tech_stack

Update version/config

remove_tech_stack

Remove technology

add_sub_agent

Register guardian agent

update_sub_agent

Modify agent config

sync_claude_code_agents

Sync from .claude/agents/

read_claude_code_agents

Read agent files

suggest_agents_for_task

AI-powered agent recommendations

update_agent_prompt_templates

Update prompt templates

add_mcp_tool

Register MCP tool

update_mcp_tool

Update tool config

suggest_tools_for_task

AI-powered tool recommendations

add_guideline

Add coding guideline

add_code_pattern

Add reusable pattern

get_task_history

Complete event timeline

get_status_history

Status transition log

get_decisions

Decision records

get_guardian_interventions

Guardian activity log

get_code_changes

Code modification history

record_decision

Log a decision with rationale

record_code_change

Log code modifications

record_guardian_intervention

Log guardian action

record_status_transition

Log status change

get_iteration_count

Count task iterations

get_task_snapshot

Task state at timestamp

rollback_task

Restore previous state

get_task_stats

Aggregate statistics

mcp__orchestro__get_project_info
mcp__orchestro__list_tasks
``

Plugin includes:
- MCP server configuration (
.mcp.json)
- 5 specialized guardian agents
- Complete README with usage examples
- Troubleshooting guide

See plugins/orchestro-suite/README.md for detailed plugin documentation.

---

- get_project_info - Project metadata and status
-
get_project_configuration - Complete project configuration
-
initialize_project_configuration - Setup default tools and guardians

- create_task - Create with assignee, priority, tags, category
-
list_tasks - Filter by status/category/tags
-
update_task - Modify any field with validation
-
delete_task - Safe deletion with dependency checks
-
get_task_context - Full context with dependencies (deprecated, use prepare_task_for_execution)
-
get_execution_order - Topological sort by dependencies
-
safe_delete_tasks_by_status - Bulk delete with safety checks

- prepare_task_for_execution - Generate codebase analysis prompt
-
save_task_analysis - Store analysis results
-
get_execution_prompt - Enriched implementation context

- decompose_story - AI-powered story → tasks decomposition with automatic analysis (autoAnalyze=true default)
-
get_user_stories - List all user stories
-
get_tasks_by_user_story - Get all child tasks
-
get_user_story_health - Monitor story completion status

- save_dependencies - Record task resource dependencies
-
get_task_dependency_graph - Visualize dependency graph
-
get_resource_usage - Find tasks using a resource
-
get_task_conflicts - Detect conflicting resource usage

- list_templates - Available prompt/code templates
-
list_patterns - Coding patterns library
-
list_learnings - Past experience records
-
render_template - Generate from template with variables
-
get_relevant_knowledge - Context-aware suggestions

- add_feedback - Record success/failure/improvement
-
get_similar_learnings - Find related experiences
-
get_top_patterns - Most frequently used patterns
-
get_trending_patterns - Recently popular patterns
-
get_pattern_stats - Detailed pattern metrics
-
detect_failure_patterns - Auto-detect risky approaches
-
check_pattern_risk - Risk assessment before using pattern

Tech Stack:
-
add_tech_stack - Add framework/library
-
update_tech_stack - Update version/config
-
remove_tech_stack - Remove technology

Sub-Agents (Guardians):
-
add_sub_agent - Register guardian agent
-
update_sub_agent - Modify agent config
-
sync_claude_code_agents - Sync from .claude/agents/
-
read_claude_code_agents - Read agent files
-
suggest_agents_for_task - AI-powered agent recommendations
-
update_agent_prompt_templates - Update prompt templates

MCP Tools Management:
-
add_mcp_tool - Register MCP tool
-
update_mcp_tool - Update tool config
-
suggest_tools_for_task - AI-powered tool recommendations

Guidelines & Patterns:
-
add_guideline - Add coding guideline
-
add_code_pattern - Add reusable pattern

- get_task_history - Complete event timeline
-
get_status_history - Status transition log
-
get_decisions - Decision records
-
get_guardian_interventions - Guardian activity log
-
get_code_changes - Code modification history
-
record_decision - Log a decision with rationale
-
record_code_change - Log code modifications
-
record_guardian_intervention - Log guardian action
-
record_status_transition - Log status change
-
get_iteration_count - Count task iterations
-
get_task_snapshot - Task state at timestamp
-
rollback_task - Restore previous state
-
get_task_stats` - Aggregate statistics

---

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "orchestro - trello for claude code": {
            "mcp-orchestro": {
                "command": "npx",
                "args": [
                    "@khaoss85/orchestro@latest"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-orchestro": {
        "command": "npx",
        "args": [
            "@khaoss85/orchestro@latest"
        ]
    }
}

> Your AI Development Conductor - From Product Vision to Production Code

Transform product ideas into reality with an intelligent orchestration system that bridges Product Managers, Developers, and AI. Orchestro conducts the entire development symphony: task decomposition, dependency tracking, pattern learning, and real-time progress visualization.

[Status]()
MCP Registry
NPM Package
[TypeScript]()
[MCP Tools]()
[License]()

---

🎯 Why Orchestro?

The Problem:
- Product Managers lose track of development progress
- Developers struggle with context switching and dependencies
- Knowledge is lost between Claude Code sessions
- No single source of truth for what's being built

The Solution: Orchestro orchestrates the entire development lifecycle:
- 👔 For PMs: Visual Kanban board, user story decomposition, progress tracking
- 👨‍💻 For Developers: AI-powered task analysis, dependency graphs, pattern learning
- 🤖 For Claude Code: Structured workflows, enriched context, knowledge retention
- 📊 For Everyone: Real-time dashboard, transparent progress, complete audit trail

Think Trello × Jira × AI - but designed specifically for AI-assisted development.

---

✨ Key Features

👔 For Product Managers & Owners

- User Story Decomposition - Write a story, AI creates technical tasks automatically - Visual Progress Board - Kanban view with real-time updates - No Technical Knowledge Required - Manage development without coding - Complete Transparency - See exactly what's being built, when, and why - Risk Awareness - Auto-flagged risks with plain English explanations

👨‍💻 For Developers

- Intelligent Task Analysis - AI analyzes codebase and suggests implementation - Dependency Tracking - Visual graphs show what depends on what - Pattern Learning - System learns from successes and failures - Conflict Prevention - Detects when tasks touch the same files - Context Retention - Never lose context between sessions

🤖 For Claude Code

- 60 MCP Tools - Complete toolkit for orchestrated development - Structured Workflows - prepare → analyze → implement → learn - Enriched Prompts - Context-aware implementation guidance - Knowledge Base - Templates, patterns, learnings persist forever

📊 For Everyone

- Real-Time Dashboard - Live updates via Socket.io - Complete History - Timeline of all decisions and changes - Rollback Capability - Undo mistakes safely - Export Everything - Markdown reports for stakeholders

---

🎼 The Development Symphony

How Orchestro Conducts Your Development

┌─────────────────────────────────────────────────────┐
│  PRODUCT MANAGER                                     │
│  "User should login with email/password"           │
└─────────────────────────────────────────────────────┘
                        ↓
            ┌──────────────────────┐
            │  ORCHESTRO AI        │
            │  Decomposes Story    │
            └──────────────────────┘
                        ↓
    ┌──────────────────────────────────────────┐
    │  7 Technical Tasks Created               │
    │  • Database schema                       │
    │  • Authentication service                │
    │  • API endpoints                         │
    │  • Frontend components                   │
    │  • State management                      │
    │  (with dependencies automatically)       │
    └──────────────────────────────────────────┘
                        ↓
            ┌──────────────────────┐
            │  DEVELOPER/CLAUDE    │
            │  Implements Tasks    │
            └──────────────────────┘
                        ↓
    ┌──────────────────────────────────────────┐
    │  PM SEES PROGRESS                        │
    │  • Kanban updates in real-time          │
    │  • Risks flagged automatically          │
    │  • Dependencies visualized              │
    └──────────────────────────────────────────┘

---

🚀 Quick Start

Option 1: From MCP Registry ⭐ (Recommended)

Orchestro is now in the Official MCP Registry!

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.