██████╗ █████╗ ██████╗ ██████╗
██╔════╝██╔══██╗██╔══██╗██╔═══██╗
██║ ███████║██████╔╝██║ ██║
██║ ██╔══██║██╔══██╗██║ ██║
╚██████╗██║ ██║██║ ██║╚██████╔╝
╚═════╝╚═╝ ╚═╝╚═╝ ╚═╝ ╚═════╝
A specialized POSIX shell command agent for Claude users. Validates AI-generated commands with safety-first design, detects dangerous patterns, and ensures POSIX compliance.
/plugin install wildcard/caro 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.
Official Claude Code skill for safe shell command generation. Auto-activates when you need help, provides safety guidance, and integrates seamlessly into your workflow. Install with /plugin install wildcard/caro
Built for DevOps engineers and SREs who refuse to sacrifice privacy for productivity
| Feature | You're here Caro | GitHub Copilot CLI | Warp AI | Kiro CLI | OpenCode |
|---|---|---|---|---|---|
| Works 100% offline | |||||
| Privacy-first design | |||||
| Air-gapped friendly | |||||
| Open source |
| Feature | You're here Caro | GitHub Copilot CLI | Warp AI | Kiro 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 | Kiro 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 | Kiro 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 →Caro comes to Claude Code! Generate safe, POSIX-compliant shell commands directly in your Claude sessions with comprehensive safety validation and educational guidance.
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 (v1.1.3):
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. Install with /plugin install wildcard/caro
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.