A specialized POSIX shell command agent with empathy and agency. Available as an MCP for Claude and as a dedicated Skill. She keeps you safe while helping Claude get the job done.
A companion with a story of loyalty and transformation
Caro is the digitalization of Kyaro (Kyarorain Kadosh), the maintainer's beloved dog. Just as a loyal companion stays by your side through every challenge, Caro is here to help you navigate the complexities of shell commands with safety and expertise.
She specializes in POSIX shell commands and understands the nuances of every platform—whether you're on macOS, Linux, Windows, GNU, or BSD. Caro brings your preferences with her wherever you deploy her, respecting your distribution of choice while keeping you safe from dangerous commands.
As Claude's loyal companion, Caro handles the shell-specific heavy lifting, allowing Claude to focus on the broader work while she ensures every command is safe, correct, and optimized for your platform.
See Caro in action as your shell companion
A companion agent built for safety, empathy, and expertise
Soft Launch Alpha — We're actively building with our community. Join us to help shape Caro's future!
Comprehensive validation blocks dangerous commands like rm -rf /, fork bombs, and destructive operations. 52 predefined safety patterns with risk-level assessment.
Works across macOS, Linux, Windows, GNU, and BSD. Understands platform-specific nuances and respects your distribution of choice.
Provides recommendations based on your platform capabilities and best practices. Distinguishes between BSD and GNU command syntax automatically.
Expert in POSIX-compliant shell commands that work reliably across systems. Portable, safe, and optimized for your terminal.
Target: Sub-100ms startup, sub-2s inference on Apple Silicon. MLX framework integration for GPU acceleration on M-series chips.
Vision: Seamless integration with Claude as an MCP server and Skill, offloading shell command inference while Claude focuses on your broader work.
Built for DevOps engineers and SREs who refuse to sacrifice privacy for productivity
| Feature | You're here Caro | GitHub Copilot CLI | Warp AI | Amazon Q CLI | OpenCode |
|---|---|---|---|---|---|
| Works 100% offline | |||||
| Zero telemetry | |||||
| Air-gapped friendly | |||||
| Open source |
| Feature | You're here Caro | GitHub Copilot CLI | Warp AI | Amazon Q CLI | OpenCode |
|---|---|---|---|---|---|
| Rule-based safety checks | |||||
| Explicit confirmation required | |||||
| Blocks dangerous commands | |||||
| Risk level assessment |
| Feature | You're here Caro | GitHub Copilot CLI | Warp AI | Amazon Q CLI | OpenCode |
|---|---|---|---|---|---|
| POSIX-first approach | |||||
| Cross-platform (macOS/Linux/BSD) | macOS/Linux | ||||
| Uses your existing terminal | |||||
| Platform-aware commands |
| Feature | You're here Caro | GitHub Copilot CLI | Warp AI | Amazon Q CLI | OpenCode |
|---|---|---|---|---|---|
| Local inference | |||||
| Multi-backend support | |||||
| Apple Silicon optimized | |||||
| Self-hostable |
Ready for a shell companion that respects your privacy?
Test your shell command knowledge! Pick the safe commands, avoid the dangerous ones.
Stories, updates, and insights about Caro
We're excited to announce that cmdai has been renamed to caro! Thanks to @aeplay for graciously transferring the crate name. Learn about the rename, new features, and how to get started.
Read full story →Discover the heartwarming story of how Kyaro, an office-loving Shiba Inu who grew up among developers and system administrators, became Caro—your eternal companion in the terminal.
Read full story →Bring your loyal shell companion to your terminal
bash <(curl --proto '=https' --tlsv1.2 -sSfL https://setup.caro.sh) Or download pre-built binaries: Coming Soon
Add Caro as an MCP server to Claude Desktop and let her handle all shell commands seamlessly.
Use Caro as a Skill to offload shell command generation and execution while Claude focuses on your work.
After running the setup script above, just use Caro:
Caro will generate the command and keep you safe. The setup script handles all prerequisites including Rust compilation.