Documentation menu

Reference

Configuration

Configure the Ontoly compiler, output format, enhancers, and analysis behavior with ontoly.config.ts or CLI flags.

Configuration file

Create an ontoly.config.ts (or .js, .json) at your repository root to customize compiler behavior. The config file is optional — Ontoly works with zero configuration for most TypeScript projects.

TERMINAL
// ontoly.config.ts
export default {
  root: '.',
  output: 'ontoly-output',
  include: ['src/**/*.ts'],
  exclude: ['**/*.test.ts', '**/*.spec.ts'],
}

Compiler options

Control what the compiler analyzes and how it produces the graph.

  • root — repository root directory (default: '.')
  • output — artifact output directory (default: 'ontoly-output')
  • include — glob patterns for files to analyze
  • exclude — glob patterns for files to skip
  • workers — number of parallel workers for analysis
  • cache — enable/disable build caching (default: true)

Output options

Control what artifacts the build produces.

  • bundle — produce a complete artifact bundle (default: true)
  • html — generate interactive HTML explorers (default: true)
  • json — output machine-readable JSON to stdout
  • reports — which report types to generate

Enhancer configuration

Enhancers are optional analysis passes that derive additional intelligence from the core graph. List and manage them with the enhancer command.

TERMINAL
ontoly enhancer list
ontoly enhancer inspect <name>
ontoly enhancer run <name>
ontoly enhancer doctor
ontoly enhancer validate