diff --git a/README.md b/README.md index 3e066353..36bd2f82 100644 --- a/README.md +++ b/README.md @@ -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 @@ -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