Temario

AcademiaMódulo 0 · Orientation

Consilience: your ontology agent workspace

Lección 1 de 37 min

Qué aprenderás

  • you can say what Consilience is in a few words: an ontology agent workspace
  • you can name the three layers (workspace, graph, agent) and say which one is the source of truth
  • you can explain how it differs from Obsidian and Notion
  • you can find your way around this course

Write notes long enough and your knowledge ends up scattered. The person you met is in one note, the company they work for is in another, the product that company makes is in a third. Each note is fine on its own, but ask "so how do these connect?" and neither search nor folders can answer.

Consilience finds those connections for you. It reads the notes you write and pulls out the people, companies, products, and ideas inside them, along with how they relate. Your scattered notes become a connected knowledge graph.

A built-in AI agent walks those connections to answer questions no single note holds on its own. You don't have to add wikilinks. Just write the way you always do.

A folder that connects itself

A Consilience workspace is just a folder on your disk. There's no import step and no special file format. Your markdown notes, PDFs, code, and images stay as ordinary files. The app watches that folder, so an edit you make in Finder or the terminal shows up right away.

  • Your notes stay plain markdown from start to finish. Extraction (the AI pass that reads your files into the graph) never rewrites them.
  • Removing a workspace from the recent list never touches the folder. Only the list entry goes away.
reasoning
extraction
writes notes & receipts

Knowledge graph

Entities, relations, and statements extracted from your notes into a structured graph. Every fact keeps provenance back to the exact passage it came from. And because the graph is derived, it can always be rebuilt from the workspace.

Three layers: your markdown files are the base, the knowledge graph is extracted from them, and the agent reasons on top. This is a preview; a later lesson walks through each layer in detail.

What an ontology workspace is

Open the graph view ("Knowledge graph", ⌘⇧G) and you can see what Consilience does. Every note, every entity it pulled out (a person, an organization, a place, an idea), and every relationship between them shows up as spheres joined by lines.

Click an entity to open its profile: its type, what it connects to, and the notes it appears in. Hover over a connection and Consilience shows you exactly which sentence in which note that relationship came from.

LayerWhat it isIf it's lost
Markdown workspacePlain files in a folder you own: notes, PDFs, code, imagesThe source of truth. Extraction never changes it
Knowledge graphEntities and typed relationships pulled from your notesRebuildable anytime by running extraction again
AI agentAnswers questions by following graph connections across many documentsNothing to rebuild. It reads the two layers below fresh each time

How it differs from Obsidian and Notion

If you already keep notes in Obsidian, you can open that same folder as a Consilience workspace. Same markdown, same [[wikilinks]], no conversion. The difference shows up next.

  • Obsidian only shows the links you typed by hand. Consilience needs no manual links; it reads the text and pulls out the entities and relationships itself.
  • Notion AI finds and summarizes your pages. That's good for a question about one page, but it tends to miss questions that need to connect facts across many pages.
  • Consilience reasons over the graph it extracts from your notes. It walks the connections across many notes to answer, and shows you the path it took. You ask questions and get work done on top of your documents.

Comprobación rápida

An answer is spread across three notes that don't share any keywords. What lets Consilience answer the question?

How to use this course

  • Modules run in order, from your first steps to real workflows. Lessons run from about 7 to 18 minutes.
  • Try it boxes tell you exactly what to do in the app right now.
  • Quizzes check that an idea landed. Every answer comes with a short why.
  • Progress saves in this browser, so you can stop anytime and pick up where you left off.
Workspace
A plain folder on disk that Consilience opens, one per window.
Knowledge graph
The web of entities and relationships pulled from your notes, drawn as a live 3D map.
Entity
Something your notes mention: a person, an organization, a place, an idea.
Extraction
The AI reading a file into the graph. It reads only, and never rewrites the file.
Agent
The built-in AI that answers by following graph connections across many documents.

Next

You've got the one-line version now: a markdown folder grows into a knowledge graph, and the agent reasons on top of it. Next you read that first screen card by card, point the app at your first folder, and watch the first extraction fill that graph in.

Comprobación rápida

If you delete the entire knowledge graph, what happens to your notes?

Consilience: your ontology agent workspace · Consilience Academy