About this project

Mila Companion is a toolkit designed to wrap Claude Code, turning a terminal-based tool into a collaborative assistant reachable via Telegram. It is specifically built to support a "director" model, where the companion assists the owner in managing, teaching, and monitoring multiple client-facing agents. Key capabilities include: - **Agent Management**: Tools for prevention (detecting silent channels or missed deadlines), teaching (installing new abilities into agents), and review (comparing agent output against stronger models). - **Communication Framework**: A set of "skills" (markdown-based rules) that govern tone, promise tracking, and inbox triage for client interactions. - **Operational Tools**: - `mila usage`: Tracks token spend and forecasts burn rates. - `mila chats`: A registry to monitor active chats and their status. - `mila owe`: A centralized ledger of all open promises across all clients. - `mila doctor`: A diagnostic tool to troubleshoot bot silence or connectivity issues. - **Quality Assurance**: Includes a `design_check.py` tool to mechanically verify web pages for overflow, accessibility, and theme consistency across different viewports. - **Infrastructure**: Provides deployment scripts for server setup, a permission policy system to gate tool execution, and a backup system for journals and chat cards. Note: This repository contains the skills and tools; the Telegram integration requires the separate `mila-telegram` plugin.