nucel-agent-sdk

Umbrella crate for the Nucel Agent SDK.

Provider-agnostic Rust SDK for AI coding agents. Spawn Claude Code, Codex, or OpenCode through a single AgentExecutor trait — swap providers via config, your code stays the same.

This crate re-exports:

• Everything from nucel-agent-core (traits, types, errors)
• ClaudeCodeExecutor
• CodexExecutor
• OpencodeExecutor

…plus a build_executor() factory for runtime provider selection.

Install

[dependencies]
nucel-agent-sdk = "0.1"
tokio = { version = "1", features = ["full"] }

Quick Start

use nucel_agent_sdk::{AgentExecutor, ClaudeCodeExecutor, SpawnConfig};
use std::path::Path;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let executor = ClaudeCodeExecutor::new();

    let session = executor.spawn(
        Path::new("/my/repo"),
        "Fix the failing tests",
        &SpawnConfig {
            model: Some("claude-opus-4-6".into()),
            budget_usd: Some(5.0),
            max_turns: Some(10),
            ..Default::default()
        },
    ).await?;

    let resp = session.query("Did CI pass?").await?;
    println!("{}", resp.content);

    let cost = session.total_cost().await?;
    println!("spent ${:.4}", cost.total_usd);

    session.close().await?;
    Ok(())
}

Pick a provider at runtime

use nucel_agent_sdk::{build_executor, available_providers};

let executor = build_executor("claude-code", None).unwrap();
let executor = build_executor("codex", None).unwrap();
let executor = build_executor("opencode", Some("http://localhost:4096".into())).unwrap();

for name in available_providers() {
    println!("provider: {name}");
}

Accepted aliases for Claude Code: "claude-code", "claude_code", "claudecode" (case-sensitive). "codex" and "opencode" are exact.

Feature matrix

More

• Workspace README + full feature matrix: https://github.com/nucel-dev/agent-sdk
• Architecture & "add a new provider": docs/architecture.md
• Changelog: CHANGELOG.md

License

Apache-2.0