yoyo-agent 0.1.4

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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# Session Persistence

yoyo can save and load conversations, letting you resume where you left off.

## Auto-save on exit

yoyo **automatically saves your conversation** to `.yoyo/last-session.json` every time you exit the REPL — whether via `/quit`, `/exit`, `Ctrl-D`, or even unexpected termination. No flags needed.

If a previous session is detected on startup, yoyo prints a hint:

```
  💡 Previous session found. Use --continue or /load .yoyo/last-session.json to resume.
```

## Resuming with --continue

The `--continue` (or `-c`) flag restores the last auto-saved session:

```bash
yoyo --continue
yoyo -c
```

When `--continue` is used:
1. **On startup**, yoyo loads from `.yoyo/last-session.json` (preferred) or `yoyo-session.json` (legacy fallback)
2. **On exit**, the conversation is auto-saved as usual

```bash
$ yoyo -c
  resumed session: 8 messages from .yoyo/last-session.json

main > what were we working on?
```

## Manual save/load

**Save the current conversation:**
```
/save
```
This writes to `yoyo-session.json` in the current directory.

**Save to a custom path:**
```
/save my-session.json
```

**Load a conversation:**
```
/load
/load my-session.json
/load .yoyo/last-session.json
```

## Session format

Sessions are stored as JSON files containing the conversation message history. The format is determined by the yoagent library.

## Error handling

- If no previous session exists when using `--continue`, yoyo prints a message and starts fresh
- If a session file is corrupt or can't be parsed, yoyo warns you and starts fresh
- Empty conversations (no messages exchanged) are not auto-saved
- Save errors are reported but don't crash yoyo