yoagent CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

yoagent is a Rust library (crate) for building AI coding agents. It provides a core agent loop, multi-provider LLM streaming, built-in tools, MCP integration, and context management. Published to crates.io as yoagent.

Build & Development Commands

cargo test --all-features            # Run all tests — what CI runs
cargo clippy --all-targets --all-features   # Lint — what CI runs (-Dwarnings)
cargo fmt                            # Auto-format code
cargo fmt -- --check                 # Check formatting (CI uses this)

cargo test <test_name>               # Run a single test by name
cargo test --test agent_test         # Run a specific test file
cargo run --example cli              # Run the interactive CLI example
cargo run --example basic            # Run the minimal example

Pass --all-features when checking your work. openapi and gasp are off by default, and some targets exist only behind them: gasp_emit and llm_compaction_live are both required-features = ["gasp"], so plain cargo clippy --all-targets skips them entirely and reports clean on code CI will reject. This is not hypothetical — a breaking change to CostConfig passed local clippy while llm_compaction_live no longer compiled.

CI (RUSTFLAGS="-Dwarnings") treats all clippy warnings as errors. Integration tests in tests/integration_anthropic.rs require a live API key and are skipped by default.

Architecture

Core Loop Pattern

The central abstraction is a stateless agent loop (agent_loop.rs) driven by two traits:

• StreamProvider (provider/traits.rs) — streams LLM responses via SSE into an mpsc channel, returning a complete Message
• AgentTool (types.rs) — defines tool name/schema/execution; the primary extension point for custom tools

The loop: stream assistant response → extract tool calls → execute tools (parallel by default) → append results → repeat until StopReason::Stop with no follow-ups.