Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 16 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,22 +65,7 @@ description = "Tests the game and reports bugs"
instruction = "Play-test the game, find bugs, and verify fixes."
```

### Running your expert

To let your agents work on an actual task, you can use the `perstack start` command to run them interactively:

```bash
# Let `ai-gaming` build a Wizardry-like dungeon crawler
docker run --pull always --rm -it \
-e FIREWORKS_API_KEY \
-v ./ai-gaming:/workspace \
perstack/perstack start ai-gaming \
--provider fireworks \
--model accounts/fireworks/models/kimi-k2p5 \
"Create a Wizardry-like dungeon crawler in a fixed 10-floor labyrinth with complex layouts, traps, fixed room encounters, and random battles. Include special-effect gear drops, leveling, and a skill tree for one playable character. Balance difficulty around build optimization. Death in the dungeon causes loss of one random equipped item."
```

While the agents are working, the TUI shows real-time status — active delegation tree, token usage, reasoning streams, and per-agent progress:
While `create-expert` is running, the TUI shows real-time status — active delegation tree, token usage, reasoning streams, and per-agent progress:

```
2026/03/13 08:15:40.083, @bash-gaming/game-designer, ⎇ bash-gaming
Expand All @@ -104,6 +89,21 @@ Tokens: In 391.9k · Out 38.9k · Cache 145.9k/27.13%
└ ⠇ @bash-gaming/game-designer · ○ 3.2% · Streaming Reasoning...
```

### Running your expert

To let your agents work on an actual task, you can use the `perstack start` command to run them interactively:

```bash
# Let `ai-gaming` build a Wizardry-like dungeon crawler
docker run --pull always --rm -it \
-e FIREWORKS_API_KEY \
-v ./ai-gaming:/workspace \
perstack/perstack start ai-gaming \
--provider fireworks \
--model accounts/fireworks/models/kimi-k2p5 \
"Create a Wizardry-like dungeon crawler in a fixed 10-floor labyrinth with complex layouts, traps, fixed room encounters, and random battles. Include special-effect gear drops, leveling, and a skill tree for one playable character. Balance difficulty around build optimization. Death in the dungeon causes loss of one random equipped item."
```

Here is an example of a game built with these commands: [demo-dungeon-crawler](https://github.com/FL4TLiN3/demo-dungeon-crawler). It was built entirely with Kimi K2.5 on Fireworks. You can play it directly:

```bash
Expand Down
Loading