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 one place for your team's chat, meetings, notes, and AI agents - with a shared memory, so you can ask instead of search.
Quickstart
Set up your first space in a few minutes - answer a few questions, chat with Naumu, and invite a teammate.
Finding your way around
A two-minute tour of a space - the space menu, Focus, topics, members, search, and where you create things.
Desktop app
Get Naumu in its own window on Mac, Windows, or Linux, with system notifications, an unread badge, a menu-bar icon, and links that open straight in the app.
Changelog
Every Naumu release, newest first.
Chatting with Naumu
Start a chat, ask questions, tell Naumu what happened, and bring in people, files, and voice.
Topics
Channel-like containers that organize a space's content and decide who can see it, in one move.
Focus
Focus is your inbox - the short list of conversations, notes, and views that need you, kept until you mark each one Done or Later.
Find anything
Press Cmd+K to find a chat, note, person, topic, or file, filter the results, and preview before you open.
Members & sharing
Invite people, assign roles, bring in guests, and manage who belongs to a space.
Agents
Agents are AI teammates in your space. Meet @Naumu, shape how it behaves, and add agents of your own.
Routines
Standing work Naumu does without being asked - a Monday digest on a schedule, or a nudge when a task sits too long.
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.
Agent sessions
Sync your Claude Code and Codex sessions from your computer into a space, so your team's memory includes the work done in coding agents.
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.
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 and assignees become attributes, and Lists and Folders 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.
Spaces
Create and manage spaces, control who can see them, and import or export your data.
Plans & billing
What the Free, Team, and Max plans include, how weekly credits work, how to earn more, and how to change or cancel a plan.
Account settings
Manage your profile, notification channels, API keys, and connected tools from one place - most changes save automatically as you make them.
Core concepts
The words Naumu uses - space, topic, thread, note, view, agent - and how memory and the model work underneath.
Nodes & edges
How knowledge is represented: nodes, the edges that connect them, and the hierarchy they form.
Model
See and shape the kinds of things your space remembers - types, their attributes, and how they connect.