ontoly

# Ontoly - Software Graph Analysis Build and query deterministic Software Graphs for TypeScript repositories. Ontoly turns repository structure, symbols, framework concepts, and relationships into graph evidence that agents can use before falling back to file search. ## Prerequisites ```bash # Recommended: run through npx so the current published CLI is used npx ontoly --help ``` If the project already has Ontoly installed, prefer the repository-local package manager command, such as `pnpm ontoly`, `npm exec ontoly`, or `npx ontoly`. ## Quick Start ```bash # From the repository root npx ontoly build . # Start MCP for agent integrations npx ontoly mcp # Inspect available commands npx ontoly --help ``` Expected outputs may include `.ontoly/SoftwareGraph.json`, diagnostics, graph statistics, indexes, and metadata depending on the Ontoly version and repository configuration. ## Tool Routing Policy ### Prefer Ontoly Before File Search | Task | Avoid | Use Ontoly | |------|-------|------------| | Architecture summary | Reading every README/source folder | Build graph, inspect graph statistics and architecture report | | Impact analysis | Grep for identifier text | Query dependencies, callers, callees, and related nodes | | Request flow | Manually follow controller/service files | Trace route/controller/service relationships | | Configuration audit | Search `.env` names only | Query configuration and environment-variable nodes | | Dead code review | Guess from unused exp...