Nodez

Nodez is a second brain for humans and AI.

A local-first Markdown workspace. Open a folder of notes, attach a code repository, and see how they actually connect, then hand that same graph to your AI agents over MCP.

Beta version is coming

Latest v0.5.1 · Windows 10/11 · macOS 12+ universal

Beta version is coming Downloads are paused until it lands.

Availability

A beta version is coming.

Downloads are paused while the build is prepared for beta. There is nothing to install today.

Beta version is coming. Windows and macOS builds will both be published on this page when the beta opens. Still no account and no server: the app reads and writes plain files on your disk.

Windows
Windows 10 or 11, 64-bit, with WebView2, which is already present on most machines
macOS
macOS 12 Monterey or later, one universal build for Apple Silicon and Intel
Price
Free through the beta
New in the beta

A code editor and an AI chat, in the same window.

Edit your repository and chat with AI without leaving your workspace.

Code editor

Edit your repo in place

Browse files and edit code with tabs, syntax highlighting, and familiar shortcuts.

  • Customize themes, fonts, and editor settings.
  • Save and reload with conflict detection.
  • Access recent files and view code problems.
CodeMirror 6 tabs vim mode
AI chat

Your AI, connected to your vault

Chat alongside your notes and code. Choose your provider and model per workspace.

  • Stream replies and track commands and token usage.
  • Give AI context from your active vault through MCP.
  • Review proposed edits before applying them.
Codex Claude Code 2.1+ Grok OpenCode · free models MCP
What it does

Plain files underneath, a graph on top.

Nodez does not own your knowledge. It reads a folder, builds an index beside it, and gets out of the way.

01

A vault, not a database

Markdown files on disk with wikilinks, backlinks, an outline, and preview. Delete the app tomorrow and your notes still open in anything.

02

Notes and code, one index

Attach a read-only source root. Files, symbols, imports, and package dependencies land in the same graph as your notes, under .nodez/. Explore it flat in 2D, or in a 3D force layout you can orbit.

03

Ask before you read

Trace a path from a decision note to the file it constrains. Every edge records whether it was extracted or inferred, and points back at a real line.

04

Agents get tools, not screenshots

Copy one config and your agent can query the graph, search notes, and write them back, while the attached repo stays read-only.

05

Git is the sync

Pull, commit, and push the vault from inside the app. When there is a conflict it stops and shows you, rather than picking a winner.

06

Built for big repos

The full index stays queryable while the canvas draws a capped view. Re-indexing happens on commits, not on every keystroke.

Agents

Your agent, your files, one contract.

The chat panel inside Nodez runs on the same MCP server anyone else can point at. Bring your own agent and it gets the identical tools, with no export step in between.

query_graph search_notes read_note write_note impact_of explain_edge shortest_path rebuild_graph
Copied from Settings → Agent setup
{
  "mcpServers": {
    "nodez": {
      "command": "node",
      "args": [".../scripts/nodez-mcp.mjs"],
      "env": {
        "NODEZ_VAULT_DIR": "~/Documents/MyVault"
      }
    }
  }
}
FAQ

Common questions.

Q1

What is Nodez?

A desktop app that reads a folder of plain Markdown notes and, optionally, a read-only code repository, and builds one graph of both: files, wikilinks, backlinks, code symbols, imports, and package dependencies. No proprietary database, no account.

Q2

Is Nodez an Obsidian alternative?

Same local-first, Markdown-on-disk territory as Obsidian, plus a code repository in the same graph as your notes, and that graph exposed to AI agents over MCP instead of a plugin ecosystem.

Q3

Does Nodez work offline?

Yes. It reads and writes plain files on disk, with no server or account required. Sync between machines happens over Git, which you control.

Q4

Is Nodez free?

Free while in alpha. There is no account and no server. The app reads and writes plain files on your disk.

Q5

Can AI agents use Nodez?

Yes, over MCP: query_graph, search_notes, read_note, write_note, impact_of, explain_edge, shortest_path, and rebuild_graph. An attached repository stays read-only.

Q6

Does Nodez have a code editor and an AI chat?

Both, from the beta. The attached repository opens in a tabbed CodeMirror editor with language-aware highlighting, and a chat panel supports Codex, Claude Code, Grok, and OpenCode against the active vault over the same read-only MCP tools an outside agent gets. Free models are available through OpenCode.