Skip to content
caro docs

Project Roadmap

This page shows the current development status of caro, what’s working, what’s in progress, and what’s planned for the future.

Completed Features

Section titled “Completed Features”

These features are fully implemented and working:

Core CLI

Comprehensive argument parsing, colored output, and interactive confirmation flows.

Embedded LLM

Local inference with Qwen 2.5 Coder 1.5B, no external dependencies required.

Safety Validation

52+ dangerous command patterns detected and blocked before execution.

Multi-Platform

Pre-built binaries for Linux (x64/ARM64), macOS (Intel/Silicon), and Windows.

Phase 1: Core Structure Complete

Section titled “Phase 1: Core Structure ”

| Feature | Status | |---------|--------| | CLI argument parsing | Done | | Module architecture | Done | | Backend trait system | Done | | Configuration management (TOML) | Done | | Multiple output formats (JSON, YAML, Plain) | Done |

Phase 2: Safety & Validation Complete

Section titled “Phase 2: Safety & Validation ”

| Feature | Status | |---------|--------| | Dangerous pattern detection (52+ patterns) | Done | | POSIX compliance checking | Done | | User confirmation workflows | Done | | Risk assessment with color coding | Done | | Critical path protection | Done |

Phase 3: Backend Integration Complete

Section titled “Phase 3: Backend Integration ”

| Feature | Status | |---------|--------| | Embedded MLX backend (Apple Silicon) | Done | | Embedded CPU backend (cross-platform) | Done | | Ollama local backend | Done | | vLLM HTTP API support | Done | | Response parsing with fallback | Done | | Automatic backend selection | Done |

Phase 4: Platform Intelligence Complete

Section titled “Phase 4: Platform Intelligence ”

| Feature | Status | |---------|--------| | OS/architecture detection | Done | | Shell type detection | Done | | Available command detection | Done | | Platform-specific rules (BSD vs GNU) | Done | | 2-iteration agentic refinement loop | Done | | Command execution engine | Done |

Phase 5: Production Ready Complete

Section titled “Phase 5: Production Ready ”

| Feature | Status | |---------|--------| | Published to crates.io | Done | | Install script with binary fallback | Done | | Multi-platform CI/CD | Done | | SHA256 checksum verification | Done | | Official website (caro.sh) | Done | | Documentation site | Done |

In Progress

Section titled “In Progress”

Currently under active development:

Phase 6: Optimization & Expansion In Progress

Section titled “Phase 6: Optimization & Expansion ”

| Feature | Status | |---------|--------| | Model downloading optimization | In Progress | | Performance benchmarking suite | In Progress | | Extended test coverage | In Progress | | Command history tracking | In Progress | | Learning from user feedback | Planned |

Planned Features

Section titled “Planned Features”

Features on the roadmap for future releases:

Phase 7: Advanced Features Planned

Section titled “Phase 7: Advanced Features ”

| Feature | Description | |---------|-------------| | Multi-step goal completion | Execute complex workflows with dependency resolution | | Shell script generation | Generate reusable scripts for complex workflows | | Interactive refinement | Iteratively refine commands with explanations | | Plugin system | Custom backends, validators, and extensions | | Command templates | Save and reuse common command patterns |

Phase 8: Enterprise Features Planned

Section titled “Phase 8: Enterprise Features ”

| Feature | Description | |---------|-------------| | Team configurations | Shared safety policies and backends | | Audit logging | Track all generated commands | | Custom model support | Bring your own fine-tuned models | | Air-gapped deployment | Fully offline installation packages | | SSO integration | Enterprise authentication support |

Technical Architecture

Section titled “Technical Architecture”
┌─────────────────────────────────────────────────────────────┐
│                        caro CLI                              │
├─────────────────────────────────────────────────────────────┤
│  Input Layer                                                 │
│  ├── Argument Parser (clap)                                  │
│  ├── Configuration Loader (TOML)                             │
│  └── Platform Detector                                       │
├─────────────────────────────────────────────────────────────┤
│  Processing Layer                                            │
│  ├── Agentic Loop (2-iteration refinement)                   │
│  ├── Context Enrichment                                      │
│  └── Backend Router                                          │
├─────────────────────────────────────────────────────────────┤
│  Backend Layer                                               │
│  ├── Embedded (MLX/CPU)                                      │
│  ├── Ollama                                                  │
│  └── vLLM                                                    │
├─────────────────────────────────────────────────────────────┤
│  Safety Layer                                                │
│  ├── Pattern Matcher (52+ patterns)                          │
│  ├── Risk Assessor                                           │
│  └── Confirmation Flow                                       │
├─────────────────────────────────────────────────────────────┤
│  Output Layer                                                │
│  ├── Formatter (JSON/YAML/Plain)                             │
│  ├── Execution Engine                                        │
│  └── Shell Integration                                       │
└─────────────────────────────────────────────────────────────┘

Contributing

Section titled “Contributing”

Want to help build these features? Check out: