Integrate

CLI reference

Build, search, inspect, trace, profile, and validate from a reproducible command surface — 38 commands organized by workflow.

Build commands

Commands for compiling the Software Graph and managing build artifacts.

TERMINAL

ontoly init [root]              # initialize project
ontoly build [root]             # build Software Graph
ontoly output [root]            # build and write full bundle
ontoly watch [root]             # watch and rebuild
ontoly analyze [root]           # build semantic model
ontoly semantic [root]          # print semantic model
ontoly frameworks [root]        # detect frameworks
ontoly export [path]            # write graph JSON to file

Search and inspect commands

Commands for finding and examining nodes, relationships, and architectural patterns.

TERMINAL

ontoly search <concept>         # semantic index search
ontoly find <concept>            # symbol/feature finder
ontoly locate <feature>          # feature touchpoint locator
ontoly inspect <file-or-node>    # inspect node details
ontoly trace <node>              # trace relationships
ontoly graph [root]              # print/export graph
ontoly stats [root]              # graph statistics
ontoly architecture [root]       # architecture summary

Intelligence commands

Commands for semantic analysis, impact assessment, and evidence construction.

TERMINAL

ontoly explain [query]           # architecture/feature explanation
ontoly impact <target>           # blast radius analysis
ontoly evidence <query>          # generate evidence pack
ontoly implementation-plan <task> # graph-backed plan
ontoly query <op> [target]       # structured traversal
ontoly diff <base> <head>        # graph diff

Repository intelligence

Commands that combine graph structure with Git history for ownership, churn, and stability analysis.

TERMINAL

ontoly history <cmd> [root]      # history intelligence
ontoly ownership <query>         # find likely owners
ontoly hotspots                  # high-churn nodes
ontoly churn                     # churn ranking
ontoly cochanges <query>         # co-change analysis
ontoly stability <query>         # stability scores
ontoly risk [query]              # structural risk
ontoly request-trace <route>     # route tracing

Health and reports

Commands for generating reports, running diagnostics, and checking repository health.

TERMINAL

ontoly health [root]             # repository health
ontoly repository-summary [root] # deterministic summary
ontoly coverage [root]           # coverage and trust
ontoly report [type]             # generate reports
ontoly doctor [root]             # check readiness
ontoly validate [scope]          # run validation lab

Ecosystem commands

Commands for MCP, agent skills, enhancers, and the semantic layer.

TERMINAL

ontoly mcp [--list]              # start MCP server
ontoly skills <cmd>              # manage agent skills
ontoly enhancer <cmd>            # manage enhancers
ontoly semantics <cmd>           # semantic artifacts
ontoly benchmark [root]          # benchmark builds
ontoly evaluate [root]           # semantic evaluation
ontoly leaderboard               # evaluation scores

Global flags

Flags available on every command for controlling output format, verbosity, and execution.

--json — machine-readable JSON output
--verbose / --debug — debug-level logging
--trace — trace-level logging (very detailed)
--log-json — structured JSON log output
--no-color — disable ANSI color codes
--root <path> — override repository root
--output <path> — override artifact output directory