agent-sdk-rs

agent-sdk-rs is a lightweight Rust agent framework inspired by browser-use's SDK design.

It is intentionally minimal:

small surface area
explicit control flow
simple tool integration
easy embedding into Rust binaries

This project is expected to stay lightweight by default. New features should preserve that core philosophy.

What It Is

A Rust SDK for tool-using agents with:

an Agent loop
query + query_stream
provider adapter boundary
tool execution + dependency injection
explicit completion semantics via done

Coverage (v0.1.0 alpha)

Implemented:

Anthropic provider adapter (anthropic-ai-sdk)
Agent + builder API
query and query_stream
event stream model (MessageStart, StepStart, ToolCall, ToolResult, FinalResponse, etc.)
tool registration with JSON schema
dependency map + dependency overrides
translated Claude-code-style tool set:
- bash, read, write, edit
- glob_search, grep
- todo_read, todo_write
- done
optional claude_code binary target

Out of scope right now:

non-Anthropic providers
Laminar integration

Roadmap

Near-term:

Add xAI Grok provider adapter (next)
Keep adapter trait stable across providers
Improve docs/examples while keeping core small

Non-goal:

turning this into a heavy orchestration framework

Install

[dependencies]
agent-sdk-rs = "0.1.0"

Quick Usage

1. Basic agent query

use agent_sdk_rs::{Agent, AnthropicModel};

let model = AnthropicModel::from_env("claude-sonnet-4-5")?;
let mut agent = Agent::builder().model(model).build()?;

let answer = agent.query("Hello").await?;
println!("{answer}");
# Ok::<(), Box<dyn std::error::Error>>(())

2. Streaming events

use agent_sdk_rs::{Agent, AgentEvent, AnthropicModel};
use futures_util::StreamExt;

let model = AnthropicModel::from_env("claude-sonnet-4-5")?;
let mut agent = Agent::builder().model(model).build()?;

let stream = agent.query_stream("Solve this step by step");
futures_util::pin_mut!(stream);
while let Some(event) = stream.next().await {
    match event? {
        AgentEvent::ToolCall { tool, .. } => println!("tool: {tool}"),
        AgentEvent::FinalResponse { content } => println!("final: {content}"),
        _ => {}
    }
}
# Ok::<(), Box<dyn std::error::Error>>(())

3. Claude-code tool pack

use agent_sdk_rs::tools::claude_code::{SandboxContext, all_tools};
use agent_sdk_rs::{Agent, AnthropicModel};

let model = AnthropicModel::from_env("claude-sonnet-4-5")?;
let sandbox = SandboxContext::create::<std::path::PathBuf>(None)?;

let mut agent = Agent::builder()
    .model(model)
    .tools(all_tools())
    .dependency(sandbox)
    .require_done_tool(true)
    .build()?;
# Ok::<(), Box<dyn std::error::Error>>(())

Optional Binary

Run the fun Claude-code-like binary:

cargo run --features claude-code --bin claude_code -- "list Rust files and summarize"

Environment:

ANTHROPIC_API_KEY required
ANTHROPIC_MODEL optional (default set in binary)
CLAUDE_CODE_SANDBOX optional

Examples

cargo run --example local_loop
cargo run --example di_override

License

MIT. See LICENSE.

agent-sdk-rs 0.1.0