Sudocode
Lightweight agent orchestration dev tool that lives in your repo
What is Sudocode?
Sudocode is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to lightweight agent orchestration dev tool that lives in your repo
Lightweight agent orchestration dev tool that lives in your repo
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Lightweight agent orchestration dev tool that lives in your
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx sudocodeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Sudocode
Sudocode is an in-repo agent orchestration tool that adds structured multi-agent coordination directly to your git repository. It models work as a four-tier hierarchy — Specs (intent), Issues (tasks), Agents (execution sessions), and Artifacts (code diffs/reports) — and stores everything as version-controlled markdown and JSONL files. Multiple AI agents can work in parallel by claiming unblocked issues from a dependency graph, with bidirectional feedback so agents update specs during execution. Developers use it to break large features into parallelisable sub-tasks and let Claude Code, Codex, Cursor, or other agents execute them concurrently.
Prerequisites
- Node.js 18+ and npm
- Git repository initialised in your project
- An AI coding agent such as Claude Code, Codex, or Cursor
- An MCP-compatible client if using the sudocode MCP server mode
Install sudocode globally
Install the sudocode CLI globally with npm. Alternatively use npx to avoid Node version conflicts.
npm install -g sudocodeInitialise sudocode in your repository
Run `sudocode init` from the root of your git repository. This creates the `.sudocode/` directory (gitignored) with the initial configuration file.
sudocode initConfigure your editor
Edit `.sudocode/config.json` to set your preferred editor. Supported options include vs-code, cursor, windsurf, intellij, zed, xcode, or a custom command.
{
"editor": {
"editorType": "vs-code"
}
}Start the local sudocode server
Launch the local server that agents and the web UI communicate with. Keep this running during your work session.
sudocode serverInstall the Claude Code plugin
For Claude Code users, install the sudocode plugin so Claude Code can natively create specs, claim issues, and report artifacts.
claude plugin marketplace add sudocode-ai/sudocode
claude plugin install sudocodeCreate a spec and generate issues
Describe the feature or task you want to build as a spec. Sudocode breaks it into issues with a dependency graph. Agents then claim and execute issues in topological order, enabling parallel execution.
Sudocode Examples
Client configuration
Claude Desktop MCP configuration for the sudocode server (when running it as an MCP endpoint).
{
"mcpServers": {
"sudocode": {
"command": "npx",
"args": ["sudocode", "server"]
}
}
}Prompts to try
Example prompts for working with sudocode through Claude Code or Claude Desktop.
- "Create a spec for adding OAuth2 login to this Express app and generate issues for each implementation step"
- "List all unclaimed issues with no blockers so I can assign them to parallel agents"
- "Show me the dependency graph for the current spec"
- "Mark issue #4 as completed and update the spec with what was actually implemented"
- "Run two agents in parallel: one to write unit tests and one to refactor the database layer"Troubleshooting Sudocode
sudocode init fails with 'not a git repository' error
Run `git init` first to initialise a git repository in your project root, then re-run `sudocode init`.
Agents cannot claim issues — dependency resolution hangs
Check for circular dependencies in your issue graph by running `sudocode server` and inspecting the kanban view. Circular dependencies prevent topological ordering and must be resolved by editing issue relationships.
Claude Code plugin not found after installation
Ensure you ran both `claude plugin marketplace add sudocode-ai/sudocode` and `claude plugin install sudocode`. Restart Claude Code after installation. Confirm Node.js 18+ is active in the shell Claude Code uses.
Frequently Asked Questions about Sudocode
What is Sudocode?
Sudocode is a Model Context Protocol (MCP) server that lightweight agent orchestration dev tool that lives in your repo It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Sudocode?
Follow the installation instructions on the Sudocode GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Sudocode?
Sudocode works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Sudocode free to use?
Yes, Sudocode is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Sudocode Alternatives — Similar Coding Agents Servers
Looking for alternatives to Sudocode? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Sudocode in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Sudocode?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.