Tools Suite

The CatGame tools suite provides command-line and GUI utilities for asset authoring, compilation, verification, and formal verification. All tools link against the V Engine shared library and operate on the engine's custom binary asset formats.

---

Asset Pipeline Tools

• VPak Builder
• Asset Importer
• Asset Viewer

---

Authoring Tools

• Level Editor
• Tileset Editor
• Dialogue Editor
• VFX Studio
• Animus

---

Neural Network Tools

• Edge Runner

---

Personal Intelligence Tools

• Pi Daemon
• Pi Agent

AI Tools

• Agentic Personas

---

Formal Verification

• Lean 4 Formal Proof Workspace

---

Build Integration

All tools are built as part of the standard build process:

• ./scripts/build.sh — Builds engine, game, and all tools
• Tools output to build/<preset>/bin/
• Tool-specific configuration in config/tools/ (e.g., config/tools/edge_runner.toml)

Testing

Tool unit tests are included in the test suite with the --tools flag:

• ./scripts/test.sh --tools --unit — Tool unit tests alongside engine tests
• ./scripts/test.sh --tools --all — All test modes including tools

Architecture

All tools follow a header/implementation separation pattern with small interface-focused headers and heavy implementations in .cpp files. Shared CLI parsing utilities are in tools/common/cli.hpp. Tool-specific engine code resides in engine/systems/tool/.