cersei 0.1.9

Cersei: A modular Rust SDK for building coding agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

//! # Simple Agent
//!
//! The most basic Cersei usage: create an agent with Anthropic, give it
//! filesystem + shell tools, run a prompt, and print the result.
//!
//! ```bash
//! ANTHROPIC_API_KEY=sk-ant-... cargo run --example simple_agent
//! ```

use cersei::prelude::*;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    // ── Minimal: 3 lines to run a coding agent ──────────────────────────

    let output = Agent::builder()
        .provider(Anthropic::from_env()?)
        .tools(cersei::tools::coding()) // filesystem + shell tools
        .system_prompt("You are a helpful coding assistant. Be concise.")
        .max_turns(5)
        .permission_policy(AllowAll)
        .working_dir(".")
        .run_with("List all Rust source files in the current directory and count them.")
        .await?;

    println!("─── Agent Output ───");
    println!("{}", output.text());
    println!("─── Stats ───");
    println!("Turns:       {}", output.turns);
    println!("Tool calls:  {}", output.tool_calls.len());
    println!("Input tok:   {}", output.usage.input_tokens);
    println!("Output tok:  {}", output.usage.output_tokens);
    if let Some(cost) = output.usage.cost_usd {
        println!("Cost:        ${:.4}", cost);
    }

    // Print each tool call
    for tc in &output.tool_calls {
        println!(
            "  {} ({}) → {}",
            tc.name,
            if tc.is_error { "ERR" } else { "OK" },
            tc.duration.as_millis()
        );
    }

    Ok(())
}