agent-harness 0.1.0

Use existing agent CLIs (Claude Code, Codex, bob) programmatically from Rust — or add your own — behind one Harness trait + a normalized run-event stream. Imported as `harness`.
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

//! Make sure a harness is installed + signed in before you run it.
//!
//! `cargo run --example setup`
//!
//! `readiness()` reports whether the CLI is installed and authenticated;
//! `install()` installs it (npm for claude/codex; a bundled script for bob)
//! and `login()` runs the CLI's own OAuth (`claude auth login` / `codex
//! login`, which opens the browser). bob has no `login()` — store its API
//! key instead (see the `bob-rs` crate).

use std::sync::Arc;

use harness::{Claude, Harness, HarnessError, InstallEvent};

fn main() -> Result<(), HarnessError> {
    let claude = Claude::new();

    // A logger for the install/login progress stream.
    let log: harness::InstallCallback = Arc::new(|ev| match ev {
        InstallEvent::Step { text } => eprintln!("• {text}"),
        InstallEvent::Stdout { text } | InstallEvent::Stderr { text } => eprintln!("  {text}"),
        InstallEvent::Done { ok, .. } => eprintln!("done (ok={ok})"),
    });

    let r = claude.readiness();
    // Fallible calls return the typed `HarnessError`; `?` propagates it.
    if !r.installed {
        claude.install(Arc::clone(&log))?; // npm i -g @anthropic-ai/claude-code
    }
    if !r.auth_configured {
        claude.login(log)?; // `claude auth login` — opens the browser
    }

    println!("ready: {}", claude.readiness().ready);
    Ok(())
}