[](https://www.npmjs.com/package/@yodakeisuke/mcp-micromanage)
# mcp-micromanage
Control your coding agent colleague who tends to go off track.
If [sequentialthinking](https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking) is a dynamic formulation and externalization of thought workflows, this tool is a dynamic formulation and externalization of development task flows.
## Motivation
### Challenges with Coding Agents
- Coding agents often make modifications beyond what they're asked to do
- Assuming cursor+claude
- They struggle to request user feedback at key decision points during implementation
- Work plans and progress tracking can be challenging to visualize and monitor
### Solution
- **Commit and PR-based Work Plans**: Force implementation plans that break down tickets into PRs and commits as the minimum units of work
- **Forced Frequent Feedback**: Enforce user reviews at the commit level, creating natural checkpoints for feedback
- **Visualization**: Instantly understand the current work plan and implementation status through a local React app
## tool
1. **plan**: Define your implementation plan with PRs and commits
2. **track**: Monitor progress and current status of all work items
3. **update**: Change status as work progresses, with mandatory user reviews
## Visualization Dashboard
The project includes a React-based visualization tool that provides:
- Hierarchical view of PRs and commits
- Real-time updates with auto-refresh
- Status-based color coding
- Zoom and pan capabilities
## Getting Started
### Headless（mcp tool only）
1. Add to your mcp json
```json
{
"mcpServers": {
"micromanage": {
"command": "npx",
"args": [
"-y",
"@yodakeisuke/mcp-micromanage"
]
}
}
}
```
2. (Highly recommended) Add the following `.mdc`s to your project
[recommended-rules](https://github.com/yodakeisuke/mcp-micromanage-your-agent/tree/main/.cursor/rules)
(Can be adjusted to your preference)
### With Visualisation
1. clone this repository
2. Add to your mcp json
```json
{
"mcpServers": {
"micromanage": {
"command": "node",
"args": [
"[CLONE_DESTINATION_PATH]/sequentialdeveloping/dist/index.js"
]
}
}
}
```
3. build server
```bash
npm install
npm run build
```
4. run frontend
```bash
cd visualization/
npm install
npm run dev
```
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
### Third-Party Software
This project uses the following third-party software:
- **MCP TypeScript SDK**: Licensed under the MIT License. Copyright © 2023-2025 Anthropic, PBC.
## Acknowledgments
- Built with [MCP (Model Context Protocol)](https://github.com/modelcontextprotocol/typescript-sdk)
- Maintained by [yodakeisuke](https://github.com/yodakeisuke)
