Getting StartedCore concepts

Core concepts

The vocabulary of Naumu — spaces, nodes, edges, schema, and views — explained in one place.

Updated June 2, 20264 min read

Naumu has a small vocabulary. Once these few terms click, the rest of the product is easy to navigate. Read top to bottom — each term builds on the one before it.

Space

A space is a knowledge graph: a collection of things and the connections between them. It is the top-level container for everything you store — all your nodes, the edges between them, the schema that governs them, your views, and your chat threads. (Each of those terms is explained below.)

Most teams keep one space per project, product, or company.

Switching spaces switches the whole workspace at once: the sidebar, the graph, and chat all follow the space you currently have open. A space can be private to you or shared with others.

Node

A node is a single thing in your space. Every node has three parts:

A type — what kind of thing it is (for example Feature, Task, Decision, or Member).
Attributes — the structured fields the type gives it. An attribute can be a single choice from a list, multiple choices, text, a number, a date, or a yes/no value. For example, a Task carries a Status (Todo, In Progress, Done) and a Priority (P0 through P3).
Content — free-form body text attached to the node, for any detail that does not fit a field.

Nodes are the building blocks of a space. Everything else simply describes how they relate, what shape they take, or how you look at them.

Edge

An edge is a labeled relationship between two nodes. Each edge has a direction (it runs from a source node to a target node) and a label that names the relationship — for example a Feature PART_OF a Product, or a Task ASSIGNED_TO a Member.

One kind of edge is special: a parent edge. Each node has at most one parent, and parent edges chain together to form the hierarchy of your space — the tree you see when you expand nodes in the sidebar.

Every other edge is a cross-link. Cross-links connect the tree sideways, relating two nodes without changing where either one lives in the hierarchy.

Node IDs are unique only within a single space. The same ID can appear in a different space and mean something else.

Schema

The schema is the blueprint for a space. It defines three things:

the node types available,
the attributes each type can hold (and the values those attributes accept), and
the connections each type is allowed to make — including which type it sits under as a parent.

Those connections come in three strengths:

a parent — where a node of this type belongs in the hierarchy,
required connections — relationships a node of this type must have, and
suggested connections — relationships that are encouraged but optional.

The schema is what keeps a growing space consistent, rather than letting it drift into a pile of loosely related notes.

You do not need a schema to begin: a space with none yet is still valid, and you can add types as you go.

View

A view is a saved, filtered way of looking at your nodes. Instead of browsing the whole graph, a view narrows to just the nodes you care about — say, every Task with a Status of In Progress — and presents them in a layout you choose: a table, a kanban board, a timeline, or a calendar.

Views can be private to you or shared with the space. While you are editing one, your changes live as a draft until you save them — so you can experiment with filters and layouts without disturbing the saved view.

Thread and chat

A thread is a conversation inside a space. Threads and their messages are nodes too — of the built-in types Thread and Message — so a conversation lives in the same graph as everything it discusses.

This is what powers chat: you talk to Naumu inside a thread, and the discussion stays attached to the space it is about. Messages can be written by people or by agents (more on those next).

Agents

Agents are AI participants in your space. They read and write the graph the same way you do — answering questions, proposing changes, and helping keep the structure clean. Naumu comes with a set of built-in agents, each with its own role (for example, gardeners that tend the schema and the density of your graph).

You stay in control: when an agent proposes a change, you see it before it lands, and nothing enters your space without your say-so.

Spaces — create and manage the workspace your graph lives in.
Quickstart — create your first space and add a few nodes.
Claude — connect AI clients like Claude and ChatGPT to your spaces over MCP.

Anything missing?

Tell us what would make these docs better.

Quickstart Spaces