ontology-atlas

Understand what your codebase builds, why it is structured that way, and what a change could affect. One shared Markdown ontology for humans and coding agents—

What is ontology-atlas?

Understand what your codebase builds, why it is structured that way, and what a change could affect. One shared Markdown ontology for humans and coding agents—visualized for people, accessible to agents through MCP, and reviewed with Git. Local-first. Open source.

Overview of ontology-atlas

What it is

Ontology Atlas is a tool that keeps a map of what your code does and why, stored as Markdown in your repository. It is read by both humans and coding agents. It is local-first and open source.

Key features

  • Your agent starts with context: Claude Code, Codex, Cursor, and Antigravity read concepts, code paths, dependencies, and open questions over MCP.
  • You own the record: one Markdown file per concept in an atlas/ folder, versioned and reviewed in Git like the code.
  • You decide what is true: agent proposals stay proposals until you accept them.
  • It says what it does not know: missing evidence shows as unknown, never as safe.
  • Local-first: no backend, account, or telemetry. The folder stays plain Markdown on your disk.
  • MCP and ACP integration: agents can read and write the folder via MCP server or in-app chat.
  • Analysis, Git, Planning, and Briefing views provide different perspectives on the ontology.

Use cases

  • Understanding the architecture and intent of a codebase.
  • Planning changes and assessing their impact before modifying code.
  • Onboarding new developers by providing a shared, versioned ontology.
  • Providing context for coding agents to improve task accuracy.
  • Documenting dependencies, unknowns, and design decisions alongside the code.

Getting started

See the repository README for quick start instructions.

License and pricing

MIT license. Open source.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/wlsdksontology-atlas.svg)](https://yunodb.com/tools/wlsdksontology-atlas?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/wlsdksontology-atlas?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/wlsdksontology-atlas.svg" alt="Featured on YunoDB" height="20"></a>