ShellSidekick

AI-powered terminal session monitoring via MCP

ShellSidekick is a Model Context Protocol (MCP) server that enables AI assistants to monitor terminal sessions in real-time, detect prompts waiting for input, and provide intelligent suggestions.

🎯 Status: Phase 6 Complete (History Search & Cleanup)

✅ Real-time session monitoring - Monitor SSH sessions and terminal output ✅ Intelligent prompt detection - Detect passwords, confirmations, file paths ✅ Context-aware suggestions - Suggest appropriate inputs with safety warnings ✅ Pattern learning - Learn from user behavior, improve suggestions over time ✅ Persistent storage - Patterns survive server restarts ✅ Session history search - Search logs with regex for debugging ✅ Automatic cleanup - Remove old session data per retention policy ✅ Fast detection - <500ms latency, >10k lines/second throughput ✅ Secure by default - Password redaction, dangerous command detection

Features

Implemented

• Session Monitoring: Monitor SSH, scripts, and terminal logs in real-time
• Prompt Detection: Automatically detect 7 prompt types (password, yes/no, choice, path, text, command, unknown)
• Smart Suggestions: Context-aware input suggestions with danger warnings
• Pattern Learning: Learn from user behavior to improve suggestions over time
• Persistent Patterns: Patterns saved to JSON, survive server restarts
• High Performance: <500ms detection latency, process >10,000 lines/second
• Security: Password redaction, dangerous operation detection, secure file permissions
• MCP Integration: 9 MCP tools for session management, detection, suggestions, pattern learning, and history search

Quick Start

See QUICKSTART.md for detailed step-by-step guide with real-world examples!