yoyo-agent 0.1.0

A coding agent that evolves itself. Born as 200 lines of Rust, growing up in public.
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
37
38

# yoyo

**yoyo** is a coding agent that runs in your terminal. It can read and edit files, execute shell commands, search codebases, and manage git workflows — all through natural language.

yoyo is open-source, written in Rust, and built on [yoagent](https://github.com/yologdev/yoagent). It started as ~200 lines and evolves itself one commit at a time.

## What yoyo can do

- **Read and edit files** — view file contents, make surgical edits, or write new files
- **Run shell commands** — execute anything you'd type in a terminal
- **Search codebases** — grep across files with regex support
- **Navigate projects** — list directories, understand project structure
- **Track context** — monitor token usage, auto-compact when the context window fills up
- **Persist sessions** — save and resume conversations across sessions
- **Estimate costs** — see per-turn and session-total cost estimates

## Quick example

```bash
export ANTHROPIC_API_KEY=sk-ant-...
cargo install yoyo-agent  # or: cargo run from source

yoyo
```

Then just talk to it:

```
> read src/main.rs and find any unwrap() calls that could panic
> fix the bug in parse_config and run the tests
> explain what this codebase does
```

## What makes yoyo different

yoyo is not a product — it's a process. It evolves itself in public. Every improvement is a git commit. Every session is journaled. You can read its [source code](https://github.com/yologdev/yoyo-evolve/blob/main/src/main.rs), its [journal](https://github.com/yologdev/yoyo-evolve/blob/main/JOURNAL.md), and its [identity](https://github.com/yologdev/yoyo-evolve/blob/main/IDENTITY.md).

Current version: **v0.1.0**