Dev Tools

World inspection provides quick visibility into current world state and asset structure. Use ./bin/voyage world -summary to inspect state and ./bin/voyage assets to validate asset presence and structure, both returning JSON output for programmatic use.

Performance benchmarking measures time per operation with configurable step counts. Run ./bin/voyage bench -n 1000 for benchmarks and ./bin/voyage sim -steps 1000 to stress test the engine, with profiling flags and JSON output for analysis.

The CLI toolkit supports structured flags for seeding, steps, JSON output, summaries, directories, and profiling. Run ./bin/voyage ai -list to inspect available AI handlers and prompts, with CI-ready exit codes and Make-based build automation.

Build the CLI toolkit using make cli, which generates the ./bin/voyage executable. The Make-based build system produces reliable outputs with documented commands for world inspection, benchmarking, asset validation, and simulation stress testing.

Seed-based scenarios enable reproducible world state testing without manual setup. The CLI accepts seeding flags to generate specific scenarios for performance verification and diagnostic exploration across different simulation conditions.

Run performance benchmarks with profiling flags to measure operation latency, inspect world state for bottlenecks, validate asset structure for corruption, and stress test with large step counts to isolate performance issues in the simulation engine.