# cjo4m06/mcp-shrimp-task-manager

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/cjo4m06-mcp-shrimp-task-manager).**

2,121 stars · 253 forks · JavaScript · MIT

## Links

- GitHub: https://github.com/cjo4m06/mcp-shrimp-task-manager
- Homepage: https://cjo4m06.github.io/mcp-shrimp-task-manager/
- awesome-repositories: https://awesome-repositories.com/repository/cjo4m06-mcp-shrimp-task-manager.md

## Topics

`agent` `ai` `codeagent` `coding-assistant` `cursor-ai` `cursorai` `mcp` `mcp-server` `roocode` `task-list` `task-manager` `tasks` `thought-processes` `windsurf` `windsurf-ai`

## Description

This project is a framework for managing multi-agent software development workflows built on the Model Context Protocol. It functions as an AI-driven task orchestrator that decomposes complex development objectives into atomic units, tracks their lifecycle, and coordinates specialized agents to execute, verify, and refine work. By maintaining persistent project context and history, the system ensures continuity across sessions, allowing agents to retain state and adhere to established coding standards.

The system distinguishes itself through its dependency-graph task management and multi-agent coordination capabilities, which allow it to balance workloads and delegate tasks based on agent expertise and role categorization. It integrates semantic codebase indexing and search to map natural language intent to project resources, while providing a graphical interface for visualizing task dependencies and monitoring agent performance. Security is maintained through strict schema-validated request handling, resource-based permissions, and mandatory user approval for system-level command execution.

Beyond core orchestration, the platform supports extensive configuration through custom prompt templates, dynamic parameter injection, and project-wide standards enforcement. It includes robust file system operations for content inspection and structured editing, alongside web retrieval capabilities to supplement local context with real-time information. The system provides comprehensive observability through task audit trails and performance analytics to ensure transparency throughout the development lifecycle.

## Tags

### Artificial Intelligence & ML

- [Agentic Task Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-task-orchestrators.md) — Orchestrates complex development workflows by decomposing objectives into structured, executable tasks for AI agents.
- [Multi-Agent Coordination Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/orchestration-engines/ai-agent/multi-agent-coordination-systems.md) — Coordinates specialized AI agents by delegating tasks based on expertise and managing inter-agent dependencies.
- [Model Context Protocol Implementations](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-capabilities-skills-tooling/agent-tooling-protocols/model-context-protocol-implementations.md) — Implements the Model Context Protocol to enable AI agents to interact with local files, research, and task queues.
- [Multi-Agent Collaboration Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/autonomous-agents/multi-agent-collaboration-systems.md) — Enables multiple specialized AI agents to collaborate within shared workspaces for complex task execution. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/docs/agents.md))
- [Role-Based Agent Orchestration](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-orchestrators/role-based-agent-orchestration.md) — Coordinates multiple agents by assigning specific roles and operating procedures to complete complex development objectives.
- [Persistent Context Management](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-assisted-project-management/persistent-context-management.md) — Preserves project progress, history, and coding rules across sessions to ensure AI agents maintain continuity. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/docs/ko/README.md))
- [Task Decomposition Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/task-decomposition-systems.md) — Provides methods for breaking down complex objectives into actionable sub-tasks for automated agents. ([source](https://cjo4m06.github.io/mcp-shrimp-task-manager/))
- [Task Delegation](https://awesome-repositories.com/f/artificial-intelligence-ml/task-delegation.md) — Routes incoming tasks to the most suitable agent by evaluating complexity and technical requirements. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/SUB_AGENTS_SPECIFICATION.md))
- [Agentic File Editing](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-file-editing.md) — Enables AI agents to autonomously modify files using structured context markers for accurate integration. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/tools.md))
- [Workload Balancers](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-orchestration-systems/workload-balancers.md) — Automatically redistributes tasks from overloaded agents to underutilized ones to maintain overall system efficiency. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/SUB_AGENTS_SPECIFICATION.md))
- [AI Prompt Engineering Templates](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-prompt-engineering-templates.md) — Defines reusable instruction templates and standards to ensure consistent, high-quality outputs from AI-driven tools.
- [Input Validation Schemas](https://awesome-repositories.com/f/artificial-intelligence-ml/input-validation-schemas.md) — Enforces structural constraints and data consistency on incoming requests using type-based schema definitions. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/shrimp-rules.md))
- [Semantic Search](https://awesome-repositories.com/f/artificial-intelligence-ml/semantic-search.md) — Performs search functionality that understands the intent and context of queries rather than just keywords. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/tools.md))

### Development Tools & Productivity

- [Agentic Task Lifecycles](https://awesome-repositories.com/f/development-tools-productivity/agentic-task-lifecycles.md) — Manages the lifecycle of complex goals decomposed into persistent graphs of dependent agent tasks.
- [Task Execution](https://awesome-repositories.com/f/development-tools-productivity/task-execution.md) — Implements and tracks actionable steps derived from analysis to ensure work meets project standards. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/docs/api.md))
- [Shell Command Execution](https://awesome-repositories.com/f/development-tools-productivity/shell-command-execution.md) — Triggers and controls operating system shell commands with mandatory user approval for security. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/tools.md))
- [System Settings Managers](https://awesome-repositories.com/f/development-tools-productivity/system-settings-managers.md) — Provides a centralized interface for managing global system settings, including API keys and storage paths. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/tree/main/tools/task-viewer))
- [Execution Audit Trails](https://awesome-repositories.com/f/development-tools-productivity/task-dependency-management/agent-task-dependency-resolvers/sequential-task-execution/execution-audit-trails.md) — Captures the full task breakdown, sub-task outputs, and final refinement into a structured audit trail for project progress. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/tree/main/tools/task-viewer))
- [Template Management Systems](https://awesome-repositories.com/f/development-tools-productivity/template-management-systems.md) — Offers a markdown-based system for versioning and managing instruction templates that dictate agent behavior. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/tools/task-viewer/README.md))

### Security & Cryptography

- [Agent Security Runtimes](https://awesome-repositories.com/f/security-cryptography/agent-security-runtimes.md) — Enforces security policies, sandboxing, and permission controls for automated agents to protect sensitive information. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/SUB_AGENTS_SPECIFICATION.md))
- [API Access Restrictions](https://awesome-repositories.com/f/security-cryptography/domain-access-restrictions/request-access-restrictions/api-access-restrictions.md) — Enforces token-based authorization and request rate limits to secure system communication and protect capacity. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/docs/api.md))
- [AI Agent Role Assignments](https://awesome-repositories.com/f/security-cryptography/role-based-access-control/workspace-role-assignments/ai-agent-role-assignments.md) — Assigns specific development roles like architect or tester to AI coding agents within a project. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/SUB_AGENTS_SPECIFICATION.md))

### Software Engineering & Architecture

- [Dependency Graph Managers](https://awesome-repositories.com/f/software-engineering-architecture/dependency-graph-managers.md) — Models and resolves task relationships in complex software projects to ensure logical execution order.
- [Feature Lifecycle Tracking](https://awesome-repositories.com/f/software-engineering-architecture/feature-lifecycle-tracking.md) — Monitors the progress of software capabilities and tasks from initial discovery through to completion. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/docs/zh/README.md))
- [Software Development Lifecycle](https://awesome-repositories.com/f/software-engineering-architecture/development-methodologies/software-development-lifecycle.md) — Automates the software development lifecycle through AI-driven reasoning, file manipulation, and task verification.
- [Multi-Agent Coordination Frameworks](https://awesome-repositories.com/f/software-engineering-architecture/multi-agent-coordination-frameworks.md) — Manages interactions and prevents conflicts between autonomous agents in a development workflow.
- [Project Rule Enforcement](https://awesome-repositories.com/f/software-engineering-architecture/project-management-governance/project-governance/standards-rule-enforcement/project-rule-enforcement.md) — Enforces project-wide coding standards and architectural constraints through configuration-driven rules for automated agents. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/tree/main/docs))
- [Specialized Agent Collections](https://awesome-repositories.com/f/software-engineering-architecture/strategic-planning-workflows/implementation-planning/agentic-plan-and-execute-workflows/specialized-agent-collections.md) — Delegates specific development tasks to curated collections of specialized agents based on defined roles and expertise. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/docs/agents.md))

### Data & Databases

- [Dynamic Parameter Injection](https://awesome-repositories.com/f/data-databases/query-engines/dynamic-parameter-injection.md) — Provides logic for injecting runtime parameters into task execution templates to ensure context-aware instruction processing. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/docs/en/prompt-customization.md))
- [Semantic Code Indexing](https://awesome-repositories.com/f/data-databases/semantic-code-indexing.md) — Maps source code structures using semantic search and call-graph traversal to provide context for AI agents.
- [Agent Task State Persistence](https://awesome-repositories.com/f/data-databases/task-result-storage/task-output-persistence/agent-task-state-persistence.md) — Preserves the internal state and progress of agent tasks to ensure continuity across sessions.

### DevOps & Infrastructure

- [Visual Task Management Boards](https://awesome-repositories.com/f/devops-infrastructure/devops/workflows/visual-task-management-boards.md) — Provides visual interfaces for tracking development progress, task status, and workflow dependencies. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager#readme))

### System Administration & Monitoring

- [Agent Performance Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/agent-performance-monitoring.md) — Provides analytical reports on agent utilization and system performance to optimize development workflows. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/SUB_AGENTS_SPECIFICATION.md))
- [Pipeline History Managers](https://awesome-repositories.com/f/system-administration-monitoring/monitoring-and-observability/observability-platforms/metric-performance-monitors/pipeline-performance-evaluators/execution-history-tracking/pipeline-history-managers.md) — Maintains a searchable record of past task executions to enable reflection and context preservation. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager#readme))

### User Interface & Experience

- [Intent Clarification](https://awesome-repositories.com/f/user-interface-experience/forms/intent-clarification.md) — Uses specialized agent-driven loops to gather missing information from users and refine implementation plans. ([source](https://github.com/cjo4m06/mcp-shrimp-task-manager/blob/main/shrimp-rules.md))

### Web Development

- [Request Schema Validators](https://awesome-repositories.com/f/web-development/request-schema-validators.md) — Verifies incoming instructions against defined schemas to prevent processing errors and ensure system consistency.