| name | gnn-cli |
| description | GNN command-line interface dispatch and health checks. Use when invoking the `gnn` CLI, validating subcommand availability, or checking command-line access to pipeline modules. |
Core Skill: cli_dispatch
Function: Unified command-line interface dispatching 12 subcommands to their respective GNN pipeline module APIs.
Example Flow
gnn run --target-dir input/gnn_files --verbose
gnn validate input/gnn_files/discrete/actinf_pomdp_agent.md --strict
gnn parse input/gnn_files/discrete/actinf_pomdp_agent.md --format json
gnn render input/gnn_files/discrete/actinf_pomdp_agent.md --framework pymdp
gnn preflight
gnn health
Programmatic Usage
from cli import main
Features
- Pipeline Execution: Full 25-step pipeline via
gnn run with --skip-steps, --only-steps, --skip-llm options
- File Validation: Section, state-space, connection, and dimension validation via
gnn validate
- Multi-Format Parsing: JSON, YAML, and summary output via
gnn parse
- Code Generation: PyMDP, RxInfer, JAX, NumPyro, Stan, PyTorch framework output via
gnn render
- Environment Checks: Dependency and configuration validation via
gnn preflight and gnn health
- Live Development: File monitoring with 250ms debounce via
gnn watch
- Dependency Graphs: Mermaid/text graph output via
gnn graph
- API & LSP Servers: FastAPI server (
gnn serve) and Language Server (gnn lsp)
MCP Tools
This module registers tools with the GNN MCP server (see mcp.py):