@orchestra-mcp/cli
v1.0.0
Published
AI-powered project management via Model Context Protocol
Maintainers
Readme
@orchestra-mcp/cli
AI-powered project management via Model Context Protocol. 57 built-in tools for managing projects, epics, stories, tasks, PRDs, workflows, memory, and more — directly from your AI assistant.
Install
# Global install
npm install -g @orchestra-mcp/cli
# Or use directly with npx
npx @orchestra-mcp/cli --helpOther install methods
# Homebrew (macOS/Linux)
brew install orchestra-mcp/tap/orchestra-mcp
# Direct download
curl -fsSL https://raw.githubusercontent.com/orchestra-mcp/mcp/master/scripts/install.sh | shQuick Start
# Initialize workspace (creates .projects/, .mcp.json, .claude/, CLAUDE.md)
orchestra-mcp init --workspace /path/to/project
# Start MCP server (stdio JSON-RPC)
orchestra-mcp --workspace /path/to/projectClaude Code Integration
Add to your .mcp.json:
{
"mcpServers": {
"orchestra": {
"command": "orchestra-mcp",
"args": ["--workspace", "."]
}
}
}Or with npx (no global install needed):
{
"mcpServers": {
"orchestra": {
"command": "npx",
"args": ["-y", "@orchestra-mcp/cli", "--workspace", "."]
}
}
}Tools (57 Built-in)
| Category | Tools |
|----------|-------|
| Project | list_projects, create_project, get_project_status, read_prd, write_prd |
| Epic | list_epics, create_epic, get_epic, update_epic, delete_epic |
| Story | list_stories, create_story, get_story, update_story, delete_story |
| Task | list_tasks, create_task, get_task, update_task, delete_task |
| Workflow | get_next_task, set_current_task, complete_task, search, get_workflow_status |
| Lifecycle | advance_task, reject_task |
| PRD | start_prd_session, answer_prd_question, get_prd_session, skip_prd_question, back_prd_question, preview_prd, split_prd, list_prd_phases, abandon_prd_session |
| Quality | report_bug, log_request |
| Memory | save_memory, search_memory, get_context, save_session, list_sessions, get_session |
| Usage | get_usage, record_usage, reset_session_usage |
| Artifacts | save_plan, list_plans |
| Claude | list_skills, list_agents, install_skills, install_agents, install_docs, receive_hook_event, get_hook_events |
| Docs | regenerate_readme |
13-State Workflow
backlog → todo → in-progress → ready-for-testing → in-testing
→ ready-for-docs → in-docs → documented → in-review → doneSpecial states: blocked, rejected (auto-creates bug), cancelled.
How It Works
This npm package downloads the pre-built orchestra-mcp binary for your platform on install. The binary is a standalone Go program with zero runtime dependencies. An optional orchestra-engine Rust binary enables gRPC-based vector search memory.
Supported platforms:
- macOS (Intel & Apple Silicon)
- Linux (x64 & ARM64)
- Windows (x64 & ARM64)
Links
License
MIT
