🚀 Coro Code

Language: English | 中文

A high-performance AI coding agent written in Rust with a rich terminal UI

Coro Code is a high-performance AI coding agent written in Rust with a rich terminal UI. Formerly known as Trae Agent Rust, it remains compatible with the original tool spec while focusing on speed, reliability, and great UX.

✨ Highlights

• 🚀 High Performance: Written in Rust for speed and memory safety
• 🎨 Rich Terminal UI: Beautiful, interactive interface with real-time updates
• 🔧 Easy Configuration: Support for multiple LLM providers with flexible config options
• 🛠️ Powerful Tools: Built-in bash execution, file operations, and extensible tool system
• 🔄 Environment Variables: Comprehensive support for API keys, base URLs, and model configuration
• 📦 Cross-Platform: Works seamlessly on macOS, Linux, and Windows

🚀 Quick Start

📋 Prerequisites

• 🦀 Rust stable (1.70+)
• 🔑 An API key (OpenAI recommended; Anthropic/Google coming soon)

📦 Install

cargo install --git https://github.com/Blushyes/coro-code --bin coro

▶️ Run

# Interactive mode (recommended)
coro

# Single task
coro "Fix the bug in main.rs"

Configuration

Option A: Environment variables

# OpenAI
export OPENAI_API_KEY="your_openai_api_key"
export OPENAI_MODEL="gpt-4o"

# Optional: Custom base URL and model for OpenAI-compatible APIs
export OPENAI_BASE_URL="https://api.deepseek.com"
export OPENAI_MODEL="deepseek-chat"

# Or use generic overrides for any protocol
export CORO_BASE_URL="https://api.custom.com"
export CORO_MODEL="custom-model"

Option B: Configuration file

Create a coro.json file:

{
  "protocol": "openai",
  "base_url": "https://api.deepseek.com",
  "api_key": "your-api-key",
  "model": "deepseek-chat",
  "params": {
    "max_tokens": 131072,
    "temperature": 0.7,
    "top_p": 0.9
  }
}

Usage

# Interactive mode
coro

# Direct command
coro "Help me refactor this function"

# With specific config
coro --config custom.json "Analyze this codebase"

🤖 Supported Models

🔧 Environment Variables Reference

🗺️ Roadmap

Status Legend: ✅ Completed | 🚧 In Progress | 📋 Planned

🛠️ Development

Context Export/Restore (Persistence)

The core supports exporting the conversation and execution context to JSON and restoring it later:

use coro_core::agent::{AgentBuilder, PersistedAgentContext};

// Export
let json = agent.export_context_json()?;                    // as JSON string
agent.export_context_to_file(".coro/context.json")?;       // or to file

// Restore
agent.restore_context_from_json(&json)?;                    // from JSON
agent.restore_context_from_file(".coro/context.json")?;    // or from file

// Work with the structured snapshot directly:
let snap = agent.export_context_snapshot()?;
let json2 = snap.to_json()?;
let snap2 = PersistedAgentContext::from_json(&json2)?;
agent.re