Quickstart

Install anyagent and run one turn against a real agent.

Requirements

• Rust 1.88 or newer (edition 2024)
• A supported agent installed and logged in
• A Tokio runtime

Install

cargo add anyagent futures tokio --features tokio/rt-multi-thread,tokio/macros

That adds these to Cargo.toml:

Cargo.toml

[dependencies]
anyagent = "0.0.2"
futures = "0.3"
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

One turn

src/main.rs

use anyagent::{EventKind, Runtime, SessionOptions};
use futures::StreamExt;

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

    // 1. Find what's on this machine, then insist on one of them.
    let report = runtime.discover().await;
    let agent = report.require("claude")?;

    // 2. Open a session: a command handle and an event stream.
    let (session, mut events) = runtime.open(agent, SessionOptions::in_dir(".")).await?;

    // 3. Prompt, then drain events until the turn ends.
    session.prompt("explain this repo").await?;
    while let Some(event) = events.next().await {
        match event?.kind {
            EventKind::TextDelta { text, .. } => print!("{text}"),
            EventKind::TurnEnded { .. } => break,
            _ => {}
        }
    }

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

What just happened:

discover()  →  report.agents (installed)  +  report.missing (with install hints)
open()      →  spawns the agent, handshakes, returns (Session, Events)
prompt()    →  starts a turn
Events      →  TurnStarted, TextDelta…, TurnEnded
close()     →  ends the process

Session is cheap to clone and every clone talks to the same engine task, so you can prompt from one task while another drains Events.

Try it from a terminal

The crate ships a binary. list and chat are the same calls as above, and their source is src/bin/anyagent.rs.

cargo install anyagent
anyagent list                           # what's installed, logged in, and capable
anyagent chat claude                    # prompt, stream, answer, steer
cargo run --example sessions -- claude  # several sessions at once, then resume

Next

Core API

The full public interface on one page.

Building an app

Threads, streaming, permissions, model picker, persistence.