AIDevTools - Sidekick MCP Server

- Thread-safe Operations: Concurrent process management with proper locking
- Automatic Cleanup: Background process monitoring with 1-hour timeout
- Graceful Shutdown: SIGTERM followed by SIGKILL for clean termination
- Memory Management: Ring buffers with automatic old data discarding
- Error Handling: Comprehensive error reporting and recovery

- Go 1.23 or later
- Git
- macOS (for audio notification testing)

curl -sSL https://raw.githubusercontent.com/eliezedeck/AIDevTools/main/install.sh | bash

curl -sSL https://raw.githubusercontent.com/eliezedeck/AIDevTools/main/install.sh | bash

git clone https://github.com/eliezedeck/AIDevTools.git
cd AIDevTools/sidekick
go build -o sidekick main.go processes.go notifications.go

sudo mv sidekick /usr/local/bin/

go install github.com/eliezedeck/AIDevTools/sidekick@latest

claude mcp add sidekick sidekick

claude mcp add sidekick -e SIDEKICK_BUFFER_SIZE=20971520 sidekick

| Variable | Default | Description |
|----------|---------|-------------|
| SIDEKICK_BUFFER_SIZE | 10485760 | Default ring buffer size (10MB) |
| SIDEKICK_CLEANUP_INTERVAL | 900 | Process cleanup interval (15 min) |
| SIDEKICK_PROCESS_TIMEOUT | 3600 | Process timeout (1 hour) |

// Monitor build process
const result = await mcp.call("spawn_process", {
  command: "npm",
  args: ["run", "build"],
  name: "production-build"
});
const processId = result.process_id;
// Get incremental output

const output = await mcp.call("get_partial_process_output", {

  process_id: processId,

  delay: 3000,

  max_lines: 100

});

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass (make test)
6. Commit your changes (git commit -m 'feat: add amazing feature')
7. Push to the branch (git push origin feature/amazing-feature)
8. Open a Pull Request

- 📖 Documentation: Check this README and Contributing Guide
- 🐛 Bug Reports: Create an issue
- 💡 Feature Requests: Request a feature
- 💬 Discussions: GitHub Discussions

<div align="center">

Production-ready MCP server for AI agent process management and notifications
Part of the AIDevTools ecosystem for AI-powered development

📖 Documentation • 🚀 Quick Start • ⭐ Features • 🛠️ API Reference • 🤝 Contributing

</div>

---

| Platform | Tools Available | Count |
|----------|----------------|-------|
| macOS | Process Management + Audio Notifications | 9 |
| Linux/Windows | Process Management Only | 8 |