← Back to all stories
5 min read

Announcing Caro: Your Terminal's AI Companion

We're excited to announce that cmdai has been renamed to caro! 🎉

A New Name, The Same Mission

Thanks to the incredible generosity of @aeplay, who graciously transferred the caro crate name to our project, we now have a name that better reflects our vision: a friendly, approachable AI companion for your terminal.

What is Caro?

caro is a single-binary Rust CLI tool that converts natural language descriptions into safe POSIX shell commands using local LLMs. Built with safety-first design and optimized for Apple Silicon via the MLX framework, caro makes complex command-line operations accessible to everyone. 

$ caro "find all PDF files larger than 10MB in Downloads"

Generated command:
  find ~/Downloads -name "*.pdf" -size +10M -ls

Execute this command? (y/N)

Why "Caro"?

The name caro offers several advantages:

  • Brevity: Shorter and easier to type (4 characters)
  • Memorability: More distinctive and memorable as a brand
  • Pronounceability: Natural pronunciation in multiple languages
  • Brandability: Better suited for a product name

In Latin, caro means "dear" or "beloved"—fitting for a tool designed to make your terminal experience more friendly and approachable. And for those who know Kyaro's story, the connection runs even deeper.

Key Features

  • 🚀 Fast startup - Single binary with quick initialization
  • 🧠 Local LLM inference - Embedded models optimized for Apple Silicon (MLX) and CPU
  • 🤖 Intelligent refinement - 2-iteration agentic loop for platform-specific commands
  • 🌍 Platform-aware - Automatically detects OS, architecture, shell, and available commands
  • 🛡️ Safety-first - Comprehensive validation with 52+ dangerous command patterns
  • 📦 Self-contained - Single binary distribution
  • 🎯 Multiple backends - Extensible system supporting MLX, CPU, vLLM, and Ollama

Getting Started

Quick Installation

# One-line setup (recommended)
bash <(curl --proto '=https' --tlsv1.2 -sSfL https://setup.caro.sh)

# Or via cargo
cargo install caro

First Command

$ caro "show me the top 5 processes by CPU usage"

caro will generate the appropriate command for your platform, validate it for safety, and ask for confirmation before execution.

What's New in v0.1.0

  • ✅ Core CLI with comprehensive argument parsing
  • ✅ Embedded model backend with MLX (Apple Silicon) and CPU variants
  • ✅ Agentic context loop with iterative refinement
  • ✅ Platform-aware command generation
  • ✅ Safety validation with 52+ dangerous command patterns
  • ✅ Remote backend support (Ollama, vLLM)
  • ✅ Interactive execution with shell detection
  • ✅ Multiple output formats (JSON, YAML, Plain)

Migration from cmdai

If you previously installed cmdai, migration is simple: 

# Uninstall old version
cargo uninstall cmdai

# Install new version
cargo install caro

# Migrate config (if you have custom configuration)
mv ~/.config/cmdai ~/.config/caro

For detailed migration instructions, see our Naming History documentation.

Thank You, @aeplay

We want to extend our heartfelt gratitude to @aeplay for:

  • Graciously transferring the caro crate name to this project
  • Believing in the project's future and potential
  • Supporting the open-source Rust community

This generosity has enabled us to have a better, more memorable name that will serve the project well as it grows.

What's Next

We have exciting plans for caro's future:

  • 📊 Enhanced analytics - Command history and usage insights
  • 🔄 Multi-step workflows - Complex task automation
  • 🎓 Learning from feedback - Adaptive command generation
  • 🔌 Plugin system - Custom backends and validators
  • 📱 Shell integration - Direct shell plugins for zsh, bash, fish

Join the Community

Try It Today

Ready to supercharge your terminal experience? 

bash <(curl --proto '=https' --tlsv1.2 -sSfL https://setup.caro.sh)

We can't wait to see what you build with caro!

Built with Rust | Safety First | Open Source

← Back to all stories