🐕 Companion Agent

Caro
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.
$ caro "find python files modified in the last 7 days"
🐕 Caro: find . -name "*.py" -type f -mtime -7
✓ Safe to run on your macOS system
Meet 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.
"In Portal 2, we learned that GLaDOS was once Caro…
🐕 Companion Agent

Caro
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.
$ caro "find python files modified in the last 7 days"
🐕 Caro: find . -name "*.py" -type f -mtime -7
✓ Safe to run on your macOS system
Meet 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.
"In Portal 2, we learned that GLaDOS was once Caroline, the secretary of Aperture Science’s founder—transformed into the eternal guardian of the facility. Like Caroline became the beating heart of the testing chambers, Caro is your eternal companion for the terminal."
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.
How Caro Works
See Caro in action as your shell companion
Why Caro?
A companion agent built for safety, empathy, and expertise
🤝
Claude’s Companion
Seamlessly integrates with Claude as an MCP and Skill, offloading shell command inference and execution while Claude focuses on your broader work.
🛡️
Safety Guardian
Comprehensive validation blocks dangerous commands like rm -rf /, fork bombs, and destructive operations. She keeps you safe like a loyal companion should.
🌍
Cross-Platform Expert
Works across macOS, Linux, Windows, GNU, and BSD. Understands platform-specific nuances and respects your distribution of choice.
🧠
Platform-Aware
Provides recommendations based on your preferences, platform capabilities, and best practices for your specific environment.
⚡
Lightning Fast
Sub-100ms startup, sub-2s inference on Apple Silicon. Optimized with MLX framework for maximum performance without sacrificing safety.
✅
POSIX Specialist
Expert in POSIX-compliant shell commands that work reliably across systems. Portable, safe, and optimized for your terminal.
Get Started with Caro
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
macOS (Apple Silicon) macOS (Intel) Linux (x86_64) Windows
Multiple Ways to Use Caro
🔧 Standalone CLI
caro "list files > 100MB"
🔌 MCP for Claude Coming Soon
Add Caro as an MCP server to Claude Desktop and let her handle all shell commands seamlessly.
✨ Dedicated Skill Coming Soon
Use Caro as a Skill to offload shell command generation and execution while Claude focuses on your work.
Quick Start
1. Install Ollama or configure your preferred backend
2. Run Caro with a natural language description:
caro "find all python files modified in the last 7 days"
3. Review the generated command and let Caro keep you safe