| name | Dev Tools |
| description | Run CLI dev tools for game development (world inspection, benchmarks, assets, simulation). Use when user wants to 'check performance', 'inspect world', 'validate assets', 'stress test', or asks about new CLI features. |
Dev Tools
CLI development tools for Stapledons Voyage game. Provides performance benchmarks, world inspection, asset validation, and simulation stress testing.
Quick Start
make cli
./bin/voyage world -summary
./bin/voyage bench -n 1000
./bin/voyage assets
./bin/voyage sim -steps 1000
When to Use This Skill
Invoke this skill when user asks to:
- "check performance" or "run benchmarks"
- "inspect world" or "show world state"
- "validate assets" or "check assets"
- "stress test" or "test simulation"
- "what CLI tools do we have?"
- Debug simulation issues or performance problems
Available Commands
World Inspection
./bin/voyage world
./bin/voyage world -summary
./bin/voyage world -json
./bin/voyage world -seed 123
./bin/voyage world -steps 100
Performance Benchmarks
./bin/voyage bench
./bin/voyage bench -n 10000
./bin/voyage bench -warmup 50
./bin/voyage bench -profile
Asset Validation
./bin/voyage assets
./bin/voyage assets -dir ./custom
./bin/voyage assets -v
./bin/voyage assets -fix
Simulation Stress Test
./bin/voyage sim
./bin/voyage sim -steps 100000
./bin/voyage sim -seed 123
./bin/voyage sim -validate
AI Handler Testing
./bin/voyage ai -list
./bin/voyage ai -prompt "Hello"
./bin/voyage ai -generate-image
./bin/voyage ai -list-voices
Scripts
scripts/quick_bench.sh
Run benchmarks with filtered output (removes debug noise).
scripts/full_report.sh
Generate comprehensive development report.
scripts/suggest_tools.sh
Analyze codebase for potential new CLI tools.
Workflow
- Build CLI -
make cli
- Run command - Execute voyage command
- Interpret results - Check output
- Report issues - Use ailang-feedback for codegen bugs
Suggesting New CLI Tools
When identifying CLI needs, consider:
voyage save - Inspect/manage save files
voyage replay - Replay recorded inputs
voyage export - Export data for analysis
voyage config - Manage game configuration
voyage starmap - Starmap data tools
To add a new tool:
- Add command case to
cmd/cli/main.go
- Implement
run<Command>Command() function
- Update this skill documentation
- Run
make cli
Known Issues
Debug output noise: Filter with | grep -v "^tick" - tracked as AILANG bug.
Resources
See resources/cli_reference.md for complete documentation.