🐕 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