🚀 Coro Code

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.restore_context_from_snapshot(snap2)?;

Notes:

• Snapshot contains conversation_history, AgentExecutionContext, and optional AgentConfig.
• On restore, saved config (if present) is applied; missing tool-result pairs are handled automatically on next execution.
• No need to manually re-inject a system prompt; the agent handles that as needed.

Pre-commit Hooks

We strongly recommend setting up pre-commit hooks to maintain code quality. The repository includes scripts to automatically install hooks that run formatting, linting, and tests before each commit.

Choose the appropriate script for your platform:

# Linux/macOS
./scripts/setup-pre-commit-hooks.sh

# Windows PowerShell
.\scripts\setup-pre-commit-hooks.ps1

# Windows Command Prompt
scripts\setup-pre-commit-hooks.bat

The pre-commit hook will automatically run:

• Code formatting (cargo fmt --check)
• Linting (cargo clippy)
• Tests (cargo test)

For more details, see scripts/README.md.

Contributing

1. Fork the repository
2. Create a feature branch
3. Set up pre-commit hooks (recommended)
4. Make your changes
5. Ensure all tests pass
6. Submit a pull request

📄 License

Dual licensed under your choice of:

• Apache-2.0 (LICENSE-APACHE)
• MIT (LICENSE-MIT)

🙏 Acknowledgments

• Trae Agent for the original Python implementation and spec
• iocraft for the beautiful terminal UI framework
• OpenAI, Anthropic, and Google for model APIs
• Rust community for the amazing ecosystem