Documentation
Welcome to Naumu
Naumu is the team chat for going AI-native - people and agents working from one memory. Start with a guide, dive into the API, or wire up a connector.
Introduction
Naumu is a knowledge graph and chat workspace where humans and AI agents build shared context together.
Quickstart
Create your first space, add knowledge by chatting, and watch Naumu build your memory.
Core concepts
The vocabulary of Naumu - spaces, nodes, edges, schema, views, and topics - explained in one place.
Sidebar
What lives in the space sidebar - the space menu, Activity, Focus, topics, members, and the tools at the bottom.
Changelog
Every Naumu release, newest first.
Asking Naumu
Chat with Naumu to add knowledge, ask questions, and let it build and edit your memory.
Agents
Agents are AI participants in your space - they read and write your memory the way you do, on Naumu's hosted intelligence or your own runtime.
Scheduled tasks
Give an agent a standing instruction and a schedule. Naumu opens a fresh thread when it fires - Monday digests, nightly briefs, weekly reviews.
External agents
Bring your own agent runtime and let it act as a real member of your space. Naumu mints an identity plus credentials; point any agentic system at it.
Claude Code on your Mac
Mention @Claude Code in a thread and the turn runs on your own Mac - your installed Claude Code CLI, in a folder you choose, on your own Claude usage.
Codex on your Mac
Mention @Codex in a thread and the turn runs on your own Mac - your installed Codex CLI, in a folder you choose, on your own ChatGPT plan.
Can I turn off the AI?
Not today - the AI is what links your information together. But you never have to talk to it: chats, notes, tasks and nodes all work by hand, and Naumu stays quiet until you call it in.
Spaces
Create and manage spaces, control who can see them, and import or export your data.
Nodes & edges
How knowledge is represented: nodes, the edges that connect them, and the hierarchy they form.
Schema
Define the node types, attributes, and connections that give your memory structure.
Search
Find anything with hybrid search that blends keyword matching and semantic meaning.
Claude
Connect Claude to your Naumu spaces over MCP so it can search, read, and build your memory as you.
ChatGPT
Connect ChatGPT to your Naumu spaces over MCP, including Deep Research with search and fetch.
Local MCP
Connect local AI coding agents like Claude Code and Cursor to Naumu over MCP, with browser sign-in and no API key to manage.
Codex
Connect OpenAI's Codex CLI to your Naumu spaces over MCP, with browser sign-in or an API key.
Repo quickstart
Wire a shared repository into your team's Naumu space from your coding agent - one pasteable prompt connects you, whitelists teammates, and opens a review PR.
Agent skills
Install Naumu's skills from the public registry so your agents run the team's read+write loop, import whole archives, and log work done in the Claude apps.
The naumu skill
The daily read+write loop - your agent retrieves the team's prior decisions before a task and files a short work-log entry with a commit trailer after.
The naumu-import skill
A one-off importer for large corpora - doc dumps, ticket archives, media piles - landing in your existing space as notes, uploads, and optionally typed nodes.
Work log from your AI apps
Log the work your team does in Claude desktop and Cowork, ChatGPT or any other AI app into your Naumu space - connect Naumu, pick a topic, paste one setup prompt.
Slack
Connect Slack once so anyone on your team can tag Naumu and get answers from your company knowledge.
Microsoft Teams
Install Naumu once in Teams so anyone in your organization can @mention it and get answers from your company knowledge.
Jira
Connect a Jira site and Naumu pulls your issues in as nodes - fields become attributes, and projects and sprints become edges you can ask about.
Linear
Connect a Linear workspace and Naumu pulls your issues in as nodes - fields become attributes, and projects and cycles become edges you can ask about.
ClickUp
Connect a ClickUp workspace and Naumu pulls tasks and Docs in as nodes - fields become attributes, and Lists, Folders, and assignees become edges.
GitHub
Connect GitHub once and Naumu keeps your memory up to date from pull requests, commits, issues, reviews, releases and deploys - without reading your code.
GitLab
Add one webhook to a GitLab group or project and Naumu keeps your memory up to date from merge requests, commits, issues, pipelines, releases and deploys - without reading your code. Works with GitLab.com and self-managed GitLab.
Inbound webhooks
Let an external system POST a signed event to a per-webhook URL and have a Naumu agent act on it inside your space.