Vix CLI is the official command-line interface for
Vix.cpp — the modern C++ backend runtime.
It provides a smooth, unified and developer-friendly workflow for creating, building and running C++20 applications.

The Vix CLI (vix) brings to C++ what tools like Cargo, Deno, Bun, and Vue CLI bring to their ecosystems:

• Simple project creation
• Fast builds with CMake presets
• Instant execution with clean logs
• Developer-oriented error messages
• Script-mode for running .cpp files like a scripting language

It finally gives C++ a modern runtime experience.

Create a complete application structure in seconds:

vix new blog

• Uses CMake presets automatically
• Detects missing configs
• Parallel builds (-j)
• Spinner & colored logs
• ErrorHandler integration for friendlier compiler diagnostics

vix run

Includes:

• Automatic build if needed
• Live filtered logs
• Runtime log-level injection
• Line-buffered stdout for real-time logs
• Clean SIGINT handling (Ctrl+C)

• Detects overload resolution issues
• Explains template deduction errors
• Detects ambiguous calls, missing includes, wrong signatures
• Clear, structured messages with hints

vix run demo.cpp

The CLI transparently:

1. Creates a temporary CMake project
2. Builds it
3. Runs it with enhanced diagnostics

vix <command> [options]

vix new blog

vix build

vix run -- --port 8080

Vix.cpp runtime is ready 🚀

Logs:

Using configuration file: config/config.json
[I] ThreadPool started with 8 workers
[I] Acceptor initialized on port 8080
[I] Server request timeout set to 5000 ms

vix run hello.cpp

The CLI uses a command registry for extensibility:

std::unordered_map<std::string, CommandHandler> commands_;

vix run automatically injects:

VIX_STDOUT_MODE=line

→ Enables real-time logs in Vix.cpp applications.

git clone https://github.com/vixcpp/vix.git
cd vix/modules/cli
cmake -B build -S .
cmake --build build -j$(nproc)

Output binary:

./build/vix

cd vix
cmake -B build -S .
cmake --build build

The CLI is included automatically.

Example:

cmake -B build -S . -DVIX_ENABLE_SANITIZERS=ON

Vix.cpp — Modern C++ backend runtime
Version: v1.6.x

Usage:
  vix [GLOBAL OPTIONS] <COMMAND> [ARGS...]

Commands:
  new <name>             Create a new Vix project
  build [name]           Configure and build a project
  run [name] [--args]    Build (if needed) and run a project
  help [command]         Show help
  version                Show CLI version

Global options:
  --verbose              Debug logs for the runtime
  -q, --quiet            Only warnings and errors
  --log-level <level>    Trace | debug | info | warn | error | critical

Examples:
  vix new api
  vix run api -- --port 8080
  vix --log-level debug run api

MIT License © Gaspard Kirira
See LICENSE for details.