Documentation menu

Start

Getting started

Install the CLI, build a Software Graph from your repository, and run your first deterministic query — in under ten minutes.

Install Ontoly

Add the CLI as a dev dependency. The executable is called ontoly and ships as a single package with no native addons.

TERMINAL
pnpm add -D @0xsarwagya/ontoly-cli@rc

Build the graph

Run the compiler from the repository root. Ontoly analyzes TypeScript and JavaScript source, detects frameworks, resolves dependencies, and writes the generated Software Graph to the ontoly-output directory. Source files are never modified.

TERMINAL
pnpm exec ontoly build .

Ask a structural question

Start with a symbol lookup, then move to impact analysis or evidence when you need a bounded traversal across the graph.

TERMINAL
pnpm exec ontoly search UserService
pnpm exec ontoly impact UserService
pnpm exec ontoly evidence "authentication flow"

What you should see

A successful build reports graph statistics, diagnostics, coverage, and a deterministic content hash. Use the hash as a regression signal across builds.

  • Software Graph with nodes and relationships
  • Compiler and graph diagnostics
  • Coverage and trust metrics
  • Deterministic FNV-1a content hash
  • Interactive HTML explorer (ontoly-output/html/graph.html)

Next steps

Explore the graph interactively, connect to an editor via MCP, or set up CI verification with Ontoly Cloud.

  • Open the HTML explorer for visual navigation
  • Run ontoly mcp to start the agent-facing server
  • Install Agent Skills for your coding agent
  • Connect to Ontoly Cloud for team-wide intelligence