Why Sage?

🚀 Quick Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/majiayu000/sage/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/majiayu000/sage/main/install.ps1 | iex

Homebrew:

brew install majiayu000/sage/sage

Cargo:

cargo install --git https://github.com/majiayu000/sage sage-cli

⚡ Quick Start

# Interactive mode (default)
sage

# Execute task interactively
sage "Create a Python script that fetches GitHub trending repos"

# Print mode - execute and exit (non-interactive)
sage -p "Explain this code"

# Continue most recent session
sage -c

# Resume specific session
sage -r <session-id>

✨ Features

🚀 Performance

• 10x faster startup - Rust native, no runtime overhead
• Single ~15MB binary - No dependencies, instant install
• Efficient memory - Low footprint, handles large codebases

🤖 Multi-LLM Support

• Anthropic - Claude Sonnet, Opus (with prompt caching)
• OpenAI - GPT-4, GPT-4 Turbo
• Google - Gemini Pro
• Ollama - Llama, Mistral, CodeLlama (offline)
• Azure OpenAI - Enterprise deployments
• OpenRouter - Access 100+ models
• Doubao - ByteDance models
• GLM - Zhipu AI models

🛠️ 40+ Built-in Tools

🧠 Advanced Features

• Memory System - Learns your coding patterns across sessions
• Checkpoints - Save and restore agent state
• Trajectory Recording - Full execution history for debugging
• MCP Protocol - Extend with Model Context Protocol servers
• Plugin System - Custom tool development

💬 Claude Code Compatible

• 16+ Slash Commands - /resume, /undo, /cost, /plan, /compact, /title, etc.
• Session Resume - Continue where you left off (sage -c or sage -r <id>)
• Interactive Mode - Multi-turn conversations
• File Change Tracking - Built-in undo support

📖 Usage

Interactive Mode

# Start interactive session
sage

# Or with initial task
sage "Create a REST API with user authentication"

> Create a REST API with user authentication

[Sage creates files, runs commands, shows progress...]

> /cost
┌─────────────────────────────────┐
│ Session Cost & Usage            │
├─────────────────────────────────┤
│ Input tokens:  12,450           │
│ Output tokens: 3,200            │
│ Total cost:    $0.047           │
└─────────────────────────────────┘

> /resume
[Shows list of previous sessions...]
To resume: sage -r <session-id>

Print Mode (One-Shot)

# Execute task and exit (non-interactive)
sage -p "Add error handling to main.rs"

# With maximum steps
sage --max-steps 30 -p "Refactor the auth module"

Session Management

# Continue most recent session
sage -c

# Resume specific session by ID
sage -r abc123

Slash Commands

Login/Logout Demo

⚙️ Configuration

Create sage_config.json or use environment variables:

{
  "default_provider": "anthropic",
  "model_providers": {
    "anthropic": {
      "model": "claude-sonnet-4-20250514",
      "api_key": "${ANTHROPIC_API_KEY}",
      "enable_prompt_caching": true
    },
    "ollama": {
      "model": "codellama",
      "base_url": "http://localhost:11434"
    }
  },
  "max_steps": 20,
  "working_directory": "."
}

Environment Variables

# API Keys
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

# Configuration
export SAGE_DEFAULT_PROVIDER="anthropic"
export SAGE_MAX_STEPS="30"

📦 SDK

Use Sage as a library in your Rust projects:

use sage_sdk::{SageAgentSdk, RunOptions};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Load from config file
    let sdk = SageAgentSdk::with_config_file("sage_config.json")?;

    // Or create with default config
    // let sdk = SageAgentSdk::new()?;

    // Run a task
    let options = RunOptions::new("Create a README file");
    let result = sdk.run(options).await?;

    println!("Execution completed: {:?}", result.outcome());

    Ok(())
}

🏗️ Architecture

sage/
├── crates/
│   ├── sage-core/      # Core agent logic, LLM providers, session, tools
│   ├── sage-cli/       # Command-line interface
│   ├── sage-sdk/       # High-level SDK for embedding
│   └── sage-tools/     # Built-in tool implementations
├── docs/               # Documentation
├── examples/           # Usage examples
└── benchmarks/         # Performance benchmarks

🧪 Benchmarks

Run the startup benchmark:

./benchmarks/startup.sh

Code Agent Startup Benchmark
━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Agent            Avg (ms)
────────────────────────────
sage             45
claude           520
aider            780

Sage is 11.5x faster than Claude Code

📚 Documentation

• User Guide - Getting started, configuration, usage
• Architecture - System design, components
• Tools Reference - All available tools
• Development - Contributing, building

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide.

# Clone
git clone https://github.com/majiayu000/sage
cd sage

# Build
cargo build --release

# Test
cargo test

# Run
./target/release/sage --help

Local developer state directories such as .claude/ and .omx/ are
intentionally ignored and should not be committed.

📄 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

Inspired by:

• Claude Code - Anthropic's CLI tool design
• Trae Agent - ByteDance's agent architecture
• Aider - AI pair programming