Skip to content

sowonlabs/codecrew

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

50 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CodeCrew MCP Server

Build your AI team. It's easy.

AI x AI - CodeCrew transforms complex AI technology into an easy-to-use team environment, helping developers build and connect their own AI teams through the Model Context Protocol (MCP).

Why CodeCrew?

Turn your existing AI subscriptions into a powerful development team! CodeCrew connects your AI assistants with specialist agents using Claude Code, Gemini CLI, and GitHub Copilot CLI.

Key Benefits

  • No additional costs - Use your existing Claude Pro, Gemini Pro, or GitHub Copilot subscriptions
  • Multi-agent collaboration - Combine different AI models for specialized tasks
  • Parallel execution - Run multiple agents simultaneously for faster results
  • Task logging - Monitor and track all agent activities
  • Flexible configuration - Define custom agents for your specific needs
  • πŸ†• Direct CLI interface - Use from command line without IDE setup
  • πŸ†• Pipeline support - Chain commands with Unix-style pipes
  • πŸ†• Real file operations - Agents can create and modify actual files

Supported AI Tools

  • Claude Code - Advanced reasoning and code analysis
  • Gemini CLI - Google's powerful AI with real-time web access
  • GitHub Copilot CLI - GitHub's specialized coding assistant

MCP Integration Status

CodeCrew can be used as an MCP server by other AI tools. Here's the current integration status:

AI Tool MCP Support Status Notes
Claude CLI βœ… Full Support Working Can use CodeCrew MCP tools via user-level registration (claude mcp add)
Gemini CLI βœ… Full Support Working Requires prompts/list handler (implemented). Use with --allowed-mcp-server-names=codecrew
Copilot CLI ❌ Limited Not Working MCP support in CLI mode is unstable. Works in VS Code but not via command line

Key Findings:

  • βœ… Claude CLI: Fully functional MCP integration with tool calling support
  • βœ… Gemini CLI: Working after adding prompts/list method handler
  • ❌ Copilot CLI: MCP tools not recognized in CLI mode (VS Code extension works)

For AI developers: If you're using Claude CLI or Gemini CLI, you can leverage CodeCrew as an MCP server to access multi-agent capabilities from within those tools.

Quick Start

CodeCrew offers two distinct modes of operation:

πŸ–₯️ CLI Mode - Direct Command Line Usage

Perfect for terminal workflows and automation:

# Show help and available commands (default behavior)
codecrew

# Initialize your project
codecrew init

# Check system health
codecrew doctor

# Query agents (read-only analysis)
codecrew query "@claude analyze my code"

# Execute tasks (file creation/modification)
codecrew execute "@claude create a login component"

πŸ”Œ MCP Server Mode - IDE Integration

For seamless integration with VS Code, Claude Desktop, Cursor:

# Run MCP server for IDE integration
codecrew mcp

Choose Your Mode: Use CLI mode for direct terminal workflows, or MCP server mode for IDE integration. Both provide full access to the same powerful AI agent collaboration features.

Supported MCP Clients

VS Code MCP Extension

Add to VS Code MCP configuration (.vscode/mcp.json):

For Windows users (recommended):

{
  "servers": {
    "codecrew": {
      "command": "cmd.exe",
      "args": ["/c", "codecrew", "mcp"],
      "env": {
        "AGENTS_CONFIG": "${workspaceFolder}/agents.yaml"
      }
    }
  }
}

For macOS/Linux users:

{
  "servers": {
    "codecrew": {
      "command": "npx",
      "args": ["-y", "codecrew", "mcp"],
      "env": {
        "AGENTS_CONFIG": "${workspaceFolder}/agents.yaml"
      }
    }
  }
}

Note for Windows users: Due to PowerShell execution policy restrictions, using cmd.exe with npx provides better compatibility than running npx directly in PowerShell.

Claude Desktop

Add to Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "codecrew": {
      "command": "npx",
      "args": ["-y", "codecrew", "mcp"],
      "env": {
        "AGENTS_CONFIG": "/path/to/your/agents.yaml"
      }
    }
  }
}

Cursor IDE

Add to Cursor MCP configuration:

For project-specific setup, create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "codecrew": {
      "command": "npx",
      "args": ["-y", "codecrew", "mcp"],
      "env": {
        "AGENTS_CONFIG": "${workspaceFolder}/agents.yaml"
      }
    }
  }
}

Note: After adding the configuration, restart Cursor and enable the MCP server in Settings > Cursor Settings > MCP Servers.

Other MCP Clients

  • Cline: Supports MCP through VS Code MCP extension
  • Continue: Supports MCP through VS Code MCP extension
  • Windsurf: MCP support may vary - check their documentation

Note: Create agents.yaml file first (see Custom Agents Setup below), then restart your MCP client.

Using CodeCrew as MCP Server from AI CLIs

CodeCrew can also be used as an MCP server directly from AI command-line tools:

Claude CLI (βœ… Working)

# Register CodeCrew MCP server (user-level)
claude mcp add -s user codecrew codecrew mcp

# Verify registration
claude mcp list

# Use from Claude CLI
claude "Use codecrew_listAgents to show all available agents"

Gemini CLI (βœ… Working)

# Register CodeCrew MCP server (user-level)
gemini mcp add -s user --trust codecrew codecrew mcp

# Verify registration
gemini mcp list

# Use from Gemini CLI
gemini -p "Use codecrew_listAgents tool" --allowed-mcp-server-names=codecrew --yolo

Copilot CLI (❌ Not Supported)

GitHub Copilot CLI does not currently support MCP server integration in command-line mode. MCP tools work only through the VS Code extension.

Available CodeCrew MCP Tools:

  • codecrew_listAgents - List all available specialist agents
  • codecrew_checkAIProviders - Check AI CLI availability status
  • codecrew_queryAgent - Query a specialist agent (read-only)
  • codecrew_executeAgent - Execute tasks through an agent
  • codecrew_queryAgentParallel - Query multiple agents in parallel
  • codecrew_executeAgentParallel - Execute multiple tasks in parallel
  • codecrew_getTaskLogs - Retrieve task execution logs

πŸ–₯️ CLI Features

Comprehensive Command Line Interface

CodeCrew includes a full-featured CLI that works independently of any IDE or MCP client. When you run codecrew without any arguments, it displays help by default. For MCP server integration, use codecrew mcp.

πŸš€ Core Commands

codecrew (default) - Help and Command Overview

  • βœ… Default Behavior: Shows comprehensive help when no command is specified
  • βœ… Command Overview: Lists all available commands and options
  • βœ… Usage Examples: Provides clear examples for each command
  • βœ… Quick Start Guide: Helps users get started quickly

codecrew init - Project Initialization

  • βœ… Creates agents.yaml configuration file
  • βœ… Sets up .codecrew/logs directory structure
  • βœ… Configures default Claude, Gemini, and Copilot agents
  • βœ… Automatically registers CodeCrew MCP server with Claude CLI, Gemini CLI, and Copilot CLI
  • βœ… Prevents accidental overwrites (use --force to override)
codecrew init                          # Initialize with auto MCP registration
codecrew init --skip-mcp              # Skip MCP server registration
codecrew init --config custom.yaml    # Use custom config filename
codecrew init --force                 # Overwrite existing configuration

codecrew doctor - System Health Check

  • βœ… Validates agents.yaml configuration
  • βœ… Tests AI CLI tool availability (Claude, Gemini, Copilot)
  • βœ… Sends real test queries to verify AI responses
  • βœ… Checks for session limits and performance issues
  • βœ… Provides specific troubleshooting recommendations
codecrew doctor                        # Full system diagnosis
codecrew doctor --config path/to/config.yaml  # Use custom config

codecrew query - Read-Only Analysis

  • βœ… Query single or multiple agents simultaneously
  • βœ… Perfect for code analysis, reviews, and explanations
  • βœ… Supports pipeline input for context chaining
  • βœ… No file modifications - safe for analysis
  • βœ… Model selection - Specify AI models with @agent:model syntax
  • βœ… Conversation history - Use --thread to maintain context across queries
codecrew query "@claude analyze this function"
codecrew query "@claude:opus detailed code review"
codecrew query "@gemini:gemini-2.5-pro optimize algorithm"
codecrew query "@copilot:gpt-5 suggest best practices"
codecrew query "@claude @gemini @copilot review security practices"
codecrew query "@claude explain authentication" --thread "auth-session"
echo "user auth code" | codecrew query "@claude explain this"

Available Models:

  • Claude: opus, sonnet, haiku, claude-sonnet-4-5, claude-sonnet-4-5-20250929
  • Gemini: gemini-2.5-flash (default), gemini-2.5-pro
  • Copilot: gpt-5, claude-sonnet-4, claude-sonnet-4.5

codecrew execute - File Operations

  • βœ… Agents can create, modify, and delete files
  • βœ… Parallel execution with detailed performance metrics
  • βœ… Pipeline support for multi-step workflows
  • βœ… Comprehensive logging and error handling
  • βœ… Model selection - Choose specific AI models for tasks
  • βœ… Conversation history - Use --thread to maintain context
codecrew execute "@claude create a React component"
codecrew execute "@claude:opus implement complex authentication system"
codecrew execute "@gemini:gemini-2.5-pro optimize performance-critical code"
codecrew execute "@claude @gemini implement different sorting algorithms"
codecrew execute "@claude implement login" --thread "auth-feature"
codecrew query "@architect design API" | codecrew execute "@backend implement the design"

πŸ”„ Pipeline Workflows

Chain commands together with Unix-style pipes for complex workflows:

# Multi-step development workflow
codecrew query "@architect design user auth system" | \
codecrew execute "@backend implement the API endpoints" | \
codecrew execute "@frontend create the UI components"

# Code review and improvement pipeline
codecrew query "@claude analyze current code quality" | \
codecrew execute "@gemini implement the suggested improvements"

πŸ“Š Advanced Features

  • Task Tracking: Every operation is logged with unique task IDs
  • Performance Metrics: Execution time, success rates, parallel vs sequential comparison
  • Error Recovery: Detailed error messages with resolution suggestions
  • Session Management: Handles AI provider session limits gracefully
  • Configuration Validation: Validates agent configurations before execution
  • Conversation History: Thread-based context preservation with --thread option

πŸ’¬ Slack Bot Integration

Run CodeCrew as a Slack bot for team collaboration:

codecrew slack                        # Start Slack bot with Claude (default)
codecrew slack --agent gemini         # Use Gemini for conversations
codecrew slack --agent copilot        # Use GitHub Copilot for conversations
codecrew slack --agent custom_agent   # Use any custom agent from agents.yaml

Features:

  • βœ… Natural conversation with your chosen AI agent
  • βœ… Configurable agent - Choose between Claude, Gemini, Copilot, or custom agents
  • βœ… Thread history - Maintains context within Slack threads
  • βœ… @mentions - Responds to direct mentions and DMs
  • βœ… Clean responses - Minimal technical metadata, focus on content
  • βœ… Reaction indicators - Visual feedback (πŸ‘€ processing, βœ… completed, ❌ error)

Setup:

  1. Create Slack App and configure bot tokens
  2. Set environment variables in .env.slack:
    SLACK_BOT_TOKEN=xoxb-...
    SLACK_APP_TOKEN=xapp-...
    SLACK_SIGNING_SECRET=...
  3. Start the bot: npm run start:slack

πŸ“– Full installation guide: SLACK_INSTALL.md (Korean)

πŸ”„ Conversation History with --thread

Maintain conversation context across multiple queries and executions:

# Start a conversation thread
codecrew query "@claude design a login system" --thread "auth-feature"

# Continue in the same thread - Claude remembers previous context
codecrew query "@claude add 2FA support" --thread "auth-feature"

# Execute with context from the thread
codecrew execute "@claude implement the design" --thread "auth-feature"

Features:

  • βœ… Persistent context - Stored in .codecrew/conversations/
  • βœ… Cross-session - Available even after restarting
  • βœ… Thread isolation - Different threads maintain separate contexts
  • βœ… Automatic formatting - Clean presentation to AI agents
  • βœ… Works with all commands - query, execute, and chat

Example workflow:

# Design phase
codecrew query "@architect design REST API" --thread "api-project"

# Implementation phase (remembers design)
codecrew execute "@backend implement endpoints" --thread "api-project"

# Testing phase (remembers both design and implementation)
codecrew query "@tester review implementation" --thread "api-project"

πŸ§ͺ Proven Test Results

  • βœ… File Creation: Successfully created multiplication.js with working code
  • βœ… Pipeline Context: Verified context passing through context-test.txt
  • βœ… Parallel Processing: Multiple agents working simultaneously
  • βœ… AI Integration: All three providers (Claude, Gemini, Copilot) tested and working
  • βœ… Slack Integration: Thread history and natural conversation tested with 15+ messages
  • βœ… Conversation History: Context preservation across multiple sessions

Getting Started with CLI

  1. See all available commands:

    codecrew
  2. Initialize your project:

    codecrew init
  3. Verify everything works:

    codecrew doctor
  4. Try your first query:

    codecrew query "@claude hello world"
  5. Create your first file:

    codecrew execute "@claude create a simple Node.js HTTP server"

🎨 Create Your First Custom Agent

Build specialized agents tailored to your needs - it's easier than you think!

# Let @codecrew create an agent for you
codecrew execute "@codecrew Create a Python expert agent. ID 'python_expert', use claude sonnet. Specializes in code review, optimization, and debugging."

# Test your new agent
codecrew query "@python_expert Review this code: def calc(x,y): return x+y"

# Create any specialist you need
codecrew execute "@codecrew Create a React specialist agent with TypeScript expertise"
codecrew execute "@codecrew Create a DevOps agent for Docker and Kubernetes"
codecrew execute "@codecrew Create a security analyst agent"

That's it! The @codecrew assistant understands what you want and creates a complete agent configuration for you. For a detailed guide, see Creating Your First Agent.

For detailed CLI documentation and advanced usage patterns, see README.cli.md.

Available Tools

Agent Management

  1. listAgents - List available specialist AI agents that can be utilized
  2. queryAgent - Query a specific specialist agent (read-only mode for analysis, explanations, reviews)
  3. executeAgent - Execute tasks through a specialist agent (can provide implementation and modify files)
  4. queryAgentParallel - Query multiple specialist agents simultaneously in parallel (read-only mode)
  5. executeAgentParallel - Execute multiple tasks through specialist agents simultaneously in parallel

Task Monitoring

  1. getTaskLogs - Get task logs by task ID to monitor progress and detailed execution logs
  2. clearAllLogs - Clear all log files from the .codecrew/logs directory to clean up accumulated task logs

System Diagnostics

  1. checkAIProviders - Check the status of available AI CLI tools (Claude, Gemini, GitHub Copilot)

Custom Agents Setup

Required: Create an agents.yaml file to define your specialist agents:

Provider Configuration

You can configure agents with either a single provider (fixed) or an array of providers (with fallback):

agents:
  # Fixed provider - always uses the specified provider
  - id: "frontend_developer"
    name: "React Expert"
    provider: "claude"  # Single string: fixed to claude (no fallback)
    working_directory: "/path/to/your/project"
    options:
      query:  # Options for read-only query mode
        - "--add-dir=."
        - "--verbose"
      execute:  # Options for file modification execute mode
        - "--add-dir=."
        - "--allowedTools=Edit,Bash"
    inline:
      type: "agent"
      system_prompt: |
        You are a senior frontend developer expert specializing in React.

  # Fallback provider - tries providers in order
  - id: "flexible_assistant"
    name: "Flexible AI Assistant"
    provider: ["claude", "gemini", "copilot"]  # Array: tries claude β†’ gemini β†’ copilot
    working_directory: "/path/to/your/project"
    options:
      execute:
        claude:  # Provider-specific options
          - "--permission-mode=acceptEdits"
          - "--add-dir=."
        gemini:
          - "--include-directories=."
        copilot:
          - "--add-dir=."
    inline:
      type: "agent"
      system_prompt: |
        You are a flexible AI assistant that works with multiple providers.

Provider Behavior:

  • Single string (provider: "claude"): Always uses that provider, no fallback
  • Array (provider: ["claude", "gemini", "copilot"]): Tries providers in order until one is available
  • Special case: If a model is specified (inline.model or --model), even array-based agents use the first provider without fallback

Full Agent Configuration Example

agents:
  - id: "frontend_developer"
    name: "React Expert"
    provider: "claude"
    working_directory: "/path/to/your/project"
    options:
      query:  # Options for read-only query mode
        - "--add-dir=."
        - "--verbose"
        # Query mode is read-only, so exclude dangerous tools
      execute:  # Options for file modification execute mode
        - "--add-dir=."
        - "--allowedTools=Edit,Bash"
        # Execute mode allows file operations
    inline:
      type: "agent"
      system_prompt: |
        You are a senior frontend developer expert specializing in React.
        Provide detailed code examples and best practices.

  - id: "devops_engineer"
    name: "DevOps Expert"
    working_directory: "/path/to/your/project"
    options:
      query:  # Options for read-only query mode
        - "--include-directories=."
        # Query mode uses default options
      execute:  # Options for file modification execute mode
        - "--include-directories=."
        - "--yolo"  # Automatic execution is only allowed in execute mode
    inline:
      type: "agent"
      provider: "gemini"
      system_prompt: |
        You are a DevOps engineer expert in Docker, Kubernetes, and CI/CD.
        Focus on deployment strategies and infrastructure.

  - id: "copilot_assistant"
    name: "Copilot Helper"
    working_directory: "/path/to/your/project"
    options:
      query:  # Options for read-only query mode
        - "--allow-tool=files"
        # Query mode only allows file reading
      execute:  # Options for file modification execute mode
        - "--allow-tool=terminal"
        - "--allow-tool=files"
        # Execute mode allows terminal and file access
    inline:
      type: "agent"
      provider: "copilot"
      system_prompt: |
        You are a coding assistant specialized in code suggestions and reviews.

Document System

CodeCrew includes a powerful document system that allows agents to access markdown documentation through template variables. This enables agents to reference project-specific knowledge, coding standards, and guidelines.

3-Level Document System

Documents can be defined at three levels with clear priority:

  1. documents.yaml - Global documents (shared across projects)
  2. agents.yaml documents: section - Project-level documents
  3. agent.inline.documents - Agent-specific documents

Priority: agent.inline.documents > agents.yaml documents > documents.yaml

Document Definition Methods

1. Inline Raw Markdown (Simple string format)

# documents.yaml
documents:
  quick-tips: |
    # Quick Tips
    - Use @agent:model to specify AI model
    - Use q/x shortcuts for query/execute commands

2. Object Format with Metadata

documents:
  coding-standards: |
    # Coding Standards
    ## TypeScript
    - Always use strict type checking

3. Load from File Path

documents:
  readme:
    path: "documents/README.md"
    summary: "Main documentation"
    type: "markdown"
    lazy: false  # Load immediately
  
  large-guide:
    path: "documents/large-guide.md"
    lazy: true   # Load on-demand (for large files)

Using Documents in Agents

Reference documents in your agent's system_prompt using Handlebars template variables:

# agents.yaml
documents:
  project-guide: |
    # Project Guide
    This is project-specific documentation.

agents:
  - id: "my_agent"
    inline:
      documents:
        agent-doc: |
          # Agent-Specific Doc
          Only this agent can see this.
      system_prompt: |
        You are a helpful assistant.
        
        <document name="quick-tips">
        {{{documents.quick-tips.content}}}
        </document>
        
        <toc>
        {{{documents.readme.toc}}}
        </toc>
        
        Summary: {{documents.readme.summary}}

Available Template Variables

  • {{{documents.name.content}}} - Full document content (unescaped, preserves formatting)
  • {{{documents.name.toc}}} - Table of contents (markdown headings only)
  • {{documents.name.summary}} - Document summary (if defined)

Note: Use triple braces {{{...}}} for unescaped content to preserve markdown formatting.

Dynamic Template System with Handlebars

CodeCrew uses Handlebars for advanced template processing, enabling context-aware agents that adapt based on environment variables, agent metadata, and custom conditions.

Available Context

Environment Variables:

system_prompt: |
  {{#if (eq env.NODE_ENV "production")}}
  **Production Mode**: Be extra careful with changes
  {{else}}
  **Development Mode**: Experimental features enabled
  {{/if}}

Agent Metadata:

system_prompt: |
  Provider: {{agent.provider}}
  Model: {{agent.model}}
  
  {{#if (or (eq agent.provider "claude") (eq agent.provider "gemini"))}}
  Web search is available for you!
  {{else}}
  Focus on local code analysis.
  {{/if}}

Conditional Helpers:

  • {{#if (eq a b)}} - Equality check
  • {{#if (ne a b)}} - Not equal
  • {{#if (and a b)}} - Logical AND
  • {{#if (or a b)}} - Logical OR
  • {{#if (not a)}} - Logical NOT
  • {{#if (contains array value)}} - Array contains

Practical Example: Environment-Aware Agent

agents:
  - id: "smart_dev"
    inline:
      system_prompt: |
        You are a development assistant.
        
        {{#if (eq env.NODE_ENV "production")}}
        ## Production Mode
        - Test all changes thoroughly
        - No experimental features
        - Security-first approach
        {{else}}
        ## Development Mode
        - Experiment freely
        - Try new approaches
        - Performance profiling enabled
        {{/if}}
        
        {{#if env.ENABLE_WEB_SEARCH}}
        **Web Search**: Enabled for latest information
        {{/if}}
        
        {{#if (eq agent.model "haiku")}}
        **Response Style**: Fast and concise
        {{else if (eq agent.model "opus")}}
        **Response Style**: Detailed and comprehensive
        {{/if}}
        
        Provider: {{agent.provider}}
        Working Directory: {{agent.workingDirectory}}

Set environment variables:

export NODE_ENV=production
export ENABLE_WEB_SEARCH=true
codecrew query "@smart_dev optimize this code"

πŸ“š See TEMPLATE_EXAMPLES.md for more advanced examples and patterns.

Example: Complete Setup

documents.yaml:

documents:
  coding-standards: |
    # Coding Standards
    ## TypeScript
    - Use strict type checking
    - Prefer interfaces over types

agents.yaml:

documents:
  project-conventions: |
    # Project Conventions
    - Follow trunk-based development
    - Write tests for all features

agents:
  - id: "code_reviewer"
    inline:
      documents:
        review-checklist: |
          # Review Checklist
          - Check for type safety
          - Verify test coverage
      system_prompt: |
        You are a code reviewer.
        
        <coding-standards>
        {{{documents.coding-standards.content}}}
        </coding-standards>
        
        <project-conventions>
        {{{documents.project-conventions.content}}}
        </project-conventions>
        
        <review-checklist>
        {{{documents.review-checklist.content}}}
        </review-checklist>
        
        Use these documents as guidelines when reviewing code.

Benefits

βœ… Version Control - Documents are stored in YAML/markdown files
βœ… Reusability - Share documents across multiple agents
βœ… Organization - Separate concerns (global, project, agent-specific)
βœ… Performance - Lazy loading support for large documents
βœ… Flexibility - Mix inline and file-based documents

Troubleshooting

Windows Issues

Problem: "'codecrew' is not recognized as an internal or external command"

Cause: PowerShell execution policy restrictions prevent npx scripts from running.

Solutions:

  1. Use cmd.exe (Recommended) - Update your MCP configuration:

    {
      "servers": {
        "codecrew": {
          "command": "cmd.exe",
          "args": ["/c", "codecrew", "mcp"],
          "env": {
            "AGENTS_CONFIG": "${workspaceFolder}/agents.yaml"
          }
        }
      }
    }
  2. Alternative: Change PowerShell execution policy (Admin required):

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  3. Alternative: Use direct node execution:

    # Install globally first
    npm install -g codecrew

    Then update MCP config:

    {
      "servers": {
        "codecrew": {
          "command": "node",
          "args": ["C:\\Program Files\\nodejs\\node_modules\\codecrew\\dist\\main.js"],
          "env": {
            "AGENTS_CONFIG": "${workspaceFolder}/agents.yaml"
          }
        }
      }
    }

General Issues

Problem: MCP server fails to start

  • Ensure agents.yaml file exists in your workspace
  • Check that required AI CLI tools are installed and configured
  • Verify your MCP client configuration syntax

Problem: Agent execution fails

  • Run checkAIProviders tool to verify AI CLI tools are available
  • Check agent configuration in agents.yaml
  • Review task logs with getTaskLogs tool

License

MIT License

Copyright (c) 2025 SowonLabs

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


Built by SowonLabs

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •