CLI Reference

# Using pipx (recommended for CLI tools)
pipx install mathviz

# Using pip
pip install mathviz

# Using uv for development
git clone https://github.com/CyberSnakeH/MathViz.git
cd MathViz
uv sync --dev

mathviz compile <input> [options]

# Compile to default output (hello.py)
mathviz compile hello.mviz

# Compile to specific output file
mathviz compile hello.mviz -o output/hello.py

# Compile with maximum optimization
mathviz compile hello.mviz --optimize 3

# Output AST for debugging
mathviz compile hello.mviz --emit ast --stdout

# Output tokens for debugging
mathviz compile hello.mviz --emit tokens --stdout

mathviz run <input> [scene] [options]

# Run with preview
mathviz run animation.mviz --preview

# Run specific scene at 720p
mathviz run animation.mviz IntroScene -q m --preview

# Render to GIF
mathviz run animation.mviz --format gif -q l

# High quality render without preview
mathviz run animation.mviz -q k -o ./renders

# Render with transparent background
mathviz run animation.mviz --transparent --format webm

# Save last frame as image
mathviz run animation.mviz --save-last-frame

mathviz exec <input> [args...]

# Execute a script
mathviz exec script.mviz

# Pass arguments to the script
mathviz exec script.mviz --input data.json --verbose

# Execute with verbose output
mathviz exec -v script.mviz

mathviz check <input> [options]

# Check for errors
mathviz check main.mviz

# Strict mode with all warnings
mathviz check main.mviz --strict

# Output as JSON (for editor integration)
mathviz check main.mviz --json

# Check multiple files
mathviz check src/*.mviz

mathviz analyze <input> [options]

# Full analysis
mathviz analyze main.mviz --all

# Check complexity only
mathviz analyze main.mviz --complexity

# Find unused code
mathviz analyze src/ --unused

# Export dependency graph
mathviz analyze src/ --dependencies --json > deps.json

mathviz fmt <input> [options]

# Format a file in place
mathviz fmt main.mviz

# Format all files in directory
mathviz fmt src/

# Check formatting (CI/CD)
mathviz fmt --check src/

# Show what would change
mathviz fmt --diff main.mviz

# Custom formatting options
mathviz fmt main.mviz --indent 2 --line-width 80

mathviz lint <input> [options]

# Lint a file
mathviz lint main.mviz

# Lint and auto-fix
mathviz lint main.mviz --fix

# Only check specific rules
mathviz lint main.mviz --select E,W

# Ignore style rules
mathviz lint main.mviz --ignore S

# Lint entire project
mathviz lint src/

mathviz watch <input> [options]

# Watch and compile on changes
mathviz watch src/

# Watch and run animation on changes
mathviz watch animation.mviz --command run

# Watch with notifications
mathviz watch src/ --notify

# Watch with custom debounce
mathviz watch src/ --debounce 500

mathviz new <name> [options]

$ mathviz new my-project
Created MathViz project: my-project/
  - src/main.mviz (template: basic)
  - mathviz.toml
  - .gitignore

my-project/
├── src/
│   └── main.mviz       # Entry point
├── tests/
├── mathviz.toml         # Project configuration
└── .gitignore

# Create a basic project
mathviz new my-project

# Create an animation project
mathviz new my-animation --template manim

# Create a math project
mathviz new my-math --template math

# Create a library
mathviz new my-lib --template lib

# Create without git
mathviz new my-project --no-git

mathviz build

$ cd my-project
$ mathviz build
Build successful: 3 file(s) compiled

mathviz info [options]

$ mathviz info
MathViz 1.0.0

Environment:
  Python: 3.11.5
  Manim: 0.18.0
  Platform: linux (x86_64)

Paths:
  Config: ~/.config/mathviz/config.toml
  Cache: ~/.cache/mathviz

Dependencies:
  numpy: 1.24.0
  scipy: 1.11.0
  numba: 0.58.0 (JIT enabled)

$ mathviz build
Build successful: 3 file(s) compiled

Update available: 0.1.7 → 0.2.0
Run: pipx upgrade mathviz

[project]
name = "my-animation"
version = "1.0.0"
entry = "src/main.mviz"

[compile]
optimize = 2
output_dir = "build"

[run]
quality = "h"
preview = true
output_dir = "media"

[fmt]
indent = 4
line_width = 100

[lint]
select = ["E", "W", "C"]
ignore = ["S001"]