Skip to main content
plugin CX Codex

ontoly — Claude Code plugin for codebase analysis

ontoly guides agents to use a Software Graph, CLI reports, and MCP when examining a repository. It covers architecture, dependencies, request paths, and change impact.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install ontoly@awesome-codex-plugins
Open on GitHub

What ontoly does

The plugin sets a graph-first workflow: an agent consults Ontoly Software Graph evidence, CLI reports, and MCP before using broad repository search. It supports architecture and dependency reviews, change-impact analysis, request tracing, and configuration checks. Security review and codebase onboarding are covered too.

The package contains Codex plugin metadata and the ontoly-software-graph skill. For repository use, the README shows installing the CLI with pnpm add -D @0xsarwagya/ontoly-cli, building a graph with pnpm ontoly build ., checking stats, and starting MCP. The documented pnpm ontoly steps depend on that CLI being installed.

What it helps with

  • review a project architecture through its graph
  • trace dependencies across components
  • assess which code a change may affect
  • follow a request through the repository
  • inspect configuration and security

Example prompts for the agent

  • Review this repository's architecture using Ontoly Software Graph.
  • Trace a request from its entry point to the handler.
  • Assess which parts of the project this module change may affect.

How to install ontoly

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install ontoly@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about ontoly

How do I install ontoly in Claude Code?

Add the marketplace with /plugin marketplace add hashgraph-online/awesome-codex-plugins, then install the plugin with /plugin install ontoly@awesome-codex-plugins.

What does the ontoly plugin do?

It steers repository analysis toward Software Graph evidence, CLI reports, and MCP before broad search. Its workflows cover architecture, dependencies, request tracing, and change impact.

What is needed to use Ontoly in a repository?

The README shows adding the CLI as a development dependency with pnpm add -D @0xsarwagya/ontoly-cli, then building the graph with pnpm ontoly build .. Start MCP with pnpm ontoly mcp.

Source text

ontoly-codex-plugin · MIT
# Ontoly Codex Plugin

[![HOL Guard](https://img.shields.io/endpoint?url=https%3A%2F%2Fhol.org%2Fapi%2Fregistry%2Fbadges%2Fguard%2Fhashgraph-online%2Fhol-guard-plugin)](https://hol.org/go/guard/sarwagyasingh69?dest=%2Fguard%2Fbilling%3Fpromo%3DGUARD20-SARWAGYASINGH69%23upgrade&link_id=8aab4f0e-d950-4ba5-89f1-5689b7c867c8&utm_source=insights_share&utm_medium=affiliate_cta&utm_campaign=share20)
[![HOL Plugin Scanner](https://github.com/0xsarwagya/ontoly-codex-plugin/actions/workflows/hol-plugin-scanner.yml/badge.svg)](https://github.com/0xsarwagya/ontoly-codex-plugin/actions/workflows/hol-plugin-scanner.yml)
[![npm install](https://img.shields.io/badge/npm-install-CB3837?logo=npm&logoColor=white)](#install-official-ontoly-skills)
[![License](https://img.shields.io/github/license/0xsarwagya/ontoly-codex-plugin)](LICENSE)
[![TypeScript](https://img.shields.io/badge/TypeScript-ready-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)

Ontoly is a TypeScript-native software intelligence engine that builds a deterministic Software Graph.

This Codex plugin teaches agents to use Ontoly graph evidence, CLI reports, MCP, and the official Ontoly Agent Skills before falling back to broad repository search.

## What Is Included

- `.codex-plugin/plugin.json` declares the Codex plugin metadata.
- `skills/ontoly-software-graph/` teaches the graph-first workflow for architecture review, dependency analysis, impact analysis, request tracing, configuration analysis, security review, and codebase onboarding.
- The full Ontoly source and official task-specific skills live in [`0xsarwagya/ontoly`](https://github.com/0xsarwagya/ontoly).

## Install Official Ontoly Skills

```bash
npx skills add 0xsarwagya/ontoly --list
npx skills add 0xsarwagya/ontoly --skill architecture-review
npx skills add 0xsarwagya/ontoly --skill impact-analysis
npx skills add 0xsarwagya/ontoly --skill request-tracing
```

## Use Ontoly In A Repository

```bash
pnpm add -D @0xsarwagya/ontoly-cli
pnpm ontoly build .
pnpm ontoly stats .
pnpm ontoly mcp
```

## Validation

```bash
python3 /Users/shrey/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py .
python3 /Users/shrey/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/ontoly-software-graph
plugin-scanner scan . --format text
```

© 0xsarwagya · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Code review and refactoring →

From the same set391

The whole set →
praxis praxis — a plugin for Claude Code and Codex that brings workflow discipline to coding agents: you state the goal and what done looks like, not the steps. CX Codex ★ 1,596repo stars project-memory-core project-memory-core keeps architectural decisions, task status, and codebase context inside a local Obsidian vault as plain Markdown files. CX Codex ★ 1,596repo stars personal-data-protection personal-data-protection is a plugin for Claude Code and Codex that groups personal-data duties in six Southeast Asian countries by stack layer. It includes checklists for new features, data fields, vendors and breaches. CX Codex ★ 1,596repo stars odw odw — a plugin for Claude Code and Codex: runs multi-agent workflows through a local daemon. Parallel agents operate in the background without blocking the main chat. CX Codex ★ 1,596repo stars oh-my-openspec oh-my-openspec — a spec-first workflow for Codex CLI and OpenCode, where an MCP gate checks the finished work against the written spec. CX Codex ★ 1,596repo stars oh-my-cassette oh-my-cassette connects Claude Code and Codex to the Cassette video editor: cuts clips to the beat, syncs music, and saves exports locally through chat. CX Codex ★ 1,596repo stars off-the-wall The off-the-wall plugin brings your earlier corrections from the same working directory back before an agent answers. Use it when you keep repeating preferences across sessions. CX Codex ★ 1,596repo stars nightshift nightshift hands the agent a time-boxed shift with a punch list kept on disk, per-item receipts, and a run history you can review in the morning. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open