AIDevTools - Sidekick MCP Server

<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>

---

📋 Table of Contents

- Overview
- Features
- Quick Start
- Installation
- Configuration
- API Reference
- Examples
- Performance
- Security
- Contributing
- Support
- License

🎯 Overview

Sidekick is a high-performance Model Context Protocol (MCP) server that provides AI agents with powerful process management and notification capabilities. Part of the AIDevTools ecosystem - a collection of tools designed to enhance AI-powered software development workflows.

Built specifically for Claude Code and other MCP-compatible AI systems, Sidekick enables AI agents to spawn, monitor, and control system processes with enterprise-grade reliability.

Why Sidekick?

- 🚀 Production Ready: Thread-safe, memory-efficient, with automatic cleanup
- 🔄 Real-time Process Management: Spawn, monitor, and control long-running processes
- 📱 Smart Notifications: Audio alerts with TTS on macOS for task completion
- 🎛️ Advanced Control: Ring buffers, stdin input, process groups, graceful shutdown
- 🌍 Cross-platform: Process management works everywhere, notifications on macOS
- ⚡ High Performance: 10MB ring buffers, efficient memory management, concurrent operations

⭐ Features

🔧 Process Management

- Multi-platform Support: Linux, macOS, Windows - Ring Buffer Output: Configurable 10MB buffers prevent memory bloat - Real-time Monitoring: "tail -f" style incremental output streaming - Process Groups: Proper child process cleanup and isolation - Stdin Support: Interactive process control with input forwarding - Smart Delays: Async/sync process spawning with configurable delays - Batch Operations: Launch multiple processes with individual configurations

📢 Audio Notifications (macOS Only)

- System Integration: Native afplay and say command integration - Concurrent Playback: Non-blocking audio and speech synthesis - Smart Limits: 50-word limit with validation for clarity

🔒 Enterprise Features

- 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

🚀 Quick Start

30-Second Setup

```bash