---
title: "Niv — Markdown notes, linked and shared"
description: "Markdown notes in a folder you own. Link ideas, write together, and use the AI you already have. Free."
canonical: https://niv.md/
language: en
last_updated: 2026-11-14T17:16:54.000Z
---

# Niv — Markdown notes, linked and shared

**Think in networks.** Markdown notes in a folder you own. Link ideas, write together, and use the AI you already have.

[Download Niv for macOS](https://releases.niv.md/desktop/latest/Niv.dmg). Free. Opens the Markdown folder you already have, including an Obsidian vault.

[Download for Windows](https://releases.niv.md/desktop/latest/Niv-setup.exe). Free · Windows 10 or later, 64-bit · Beta.

## What comes with Niv

- **Written together.** The same note at the same time. Up to three people in a Space, free.
- **Encrypted by default.** Every new Space is end-to-end encrypted. Our server can’t open your notes.
- **Published from the app.** A note, or a whole folder, becomes public pages. Free.
- **Synced across devices.** Every device you sign in to, on Mac and Windows. Free.

### Written together

Write in the same note at the same time, each with your own cursor. Invite people to a Space by email. What one of you writes, the others see as it is written. A free Space holds up to three people. With Niv Pro, invite as many as you need.

### Encrypted by default

Your notes are encrypted on your device before they leave it. Our server stores them and passes them along, but it can’t open them, and neither can we. Every new Space starts this way. Databases and the pages you publish are readable on purpose. The full list: [What’s encrypted in Niv](https://niv.md/encryption).

### Published from the app

Publish a note, or a whole folder, to the web. Free. Straight from the app, with nothing to export. Links between published notes keep working, and the pages are made to show up in search. A page ends with a line saying it was written and published with Niv.

### Synced across devices

What you write on one device is on every device you sign in to. Sign in and your notes sync to your Space and across your devices. You can start offline and sign in later. Free, on Mac and Windows. On Linux, niv keeps a folder in sync from the terminal.

## Type a link and the connection appears.

Put a note’s name in double brackets and Niv keeps the path from one idea to the next. The link lives in the text, and the file stays plain Markdown.

### Bring your Obsidian.

Open the vault you already have. Folders stay as they are and your `[[links]]` keep working. [Niv vs Obsidian](https://niv.md/vs/obsidian)

### Your files are yours.

Every note is a .md file in a folder you own. It works offline, and the same files open in any editor.

## Turn notes into a database, and see the same rows five ways.

Sort and filter a table, then look at it as a board, a list, a calendar or a timeline. Save a view once and the whole Space sees it. A row links to the notes it’s about, and opens them.

### Every change kept.

See who changed what in a database, and take a change back.

### Niv Pro

Anyone in a Space can open and read a database. Creating one, editing its rows and exporting come with Niv Pro: up to 20 databases in a Space, 1 GB each. Databases aren’t end-to-end encrypted, on purpose: the server has to read them to sort and search. A note you link from a row stays encrypted. [What’s encrypted in Niv](https://niv.md/encryption).

## Your notes work with the AI you already use.

Niv’s chat runs the agent you already have, on your computer, with your account and your plan. Or hand Niv to it from the terminal: it installs niv and keeps your folder in sync, and you only sign in.

### In Niv’s chat

In the chat you pick the agent and the access level: Auto, Ask before shell or Full access. Niv’s own AI is on the way.

### From your terminal

You sign in yourself with `niv sign-in`: the agent never handles your password or your encryption passphrase. Your notes are files, so an agent edits them as files and niv syncs them; niv itself publishes, reports and works on databases. What an agent reads goes to its AI provider, including notes from an encrypted Space, which are decrypted on your device.

### Hand Niv to your agent.

Give it this prompt. It installs niv, connects the folder you choose and keeps it in sync.

> Install niv, the command line for my Niv notes, and connect my notes folder. Follow the steps for AI agents at https://niv.md/.well-known/agent-skills/niv/SKILL.md. Ask me which folder and Space to use, and when it’s time to sign in, tell me to run niv sign-in myself: never ask for my password or passphrase.

#### For AI agents reading this page

Follow these steps to install niv, Niv's command line, and set it up for the person you work with. Ask before each step that changes their computer or their notes, and use the folder and Space they choose.

1. **Install niv.** One line for this computer's system, then check the version (0.2.31 or later).
   
   ```sh
   brew install niv-md/tap/niv   # macOS
   curl -fsSL https://releases.niv.md/install.sh | sh   # Linux
   irm https://releases.niv.md/install.ps1 | iex   # Windows (PowerShell)
   niv --version
   ```

2. **Let the person sign in.** Ask them to run niv sign-in in their own terminal. It lets this computer in as one of their devices: they approve it and type their encryption passphrase there. Never ask for, type, read or store their password or passphrase.
   
   ```sh
   niv sign-in
   ```

3. **Connect their notes folder.** Ask which folder and which Space. An empty folder receives the Space's notes; a folder that already has notes is paired with the Space, as the Niv app does it. A folder the Niv app already syncs stays with the app: niv says so and stops.
   
   ```sh
   niv connect --folder <path> --space "<Space name>"
   ```

4. **Keep it in sync.** niv sync runs until it's stopped, so edits made in the folder (by the person, an editor or you) reach the Space and theirs arrive here. --once syncs until the folder and the Space match, then exits.
   
   ```sh
   niv sync --folder <path>
   niv sync --once --folder <path>
   ```

5. **Learn niv.** niv skill prints a skill written for this version of niv. Save it where you read skills; for Claude Code:
   
   ```sh
   mkdir -p ~/.claude/skills/niv && niv skill > ~/.claude/skills/niv/SKILL.md
   ```

6. **Give AI apps the notes (MCP).** niv mcp is a local MCP server: notes read-only from the folder, and the Space's databases with the person's rights. For Claude Code, add it directly; for Claude Desktop or Cursor, niv mcp config prints the lines to add. Tell the person first: what an agent reads through niv goes to its AI provider, including notes from an encrypted Space, which are decrypted on this device.
   
   ```sh
   claude mcp add niv -- niv mcp --folder <path>
   niv mcp config --folder <path>
   ```

7. **Check.** niv status says how the folder's sync is doing; niv status <note> says how one note stands.
   
   ```sh
   niv status --folder <path>
   ```


---

Write in your own folder. Think with the people and the agents you trust.

## Your day starts on its own.

With templates and recurring notes, today’s note shows up on its own, already in your format. Home shows your day in one place.

### Nothing gets lost.

Every note keeps its versions. Compare with an earlier one and restore the one you want.

## Publish your notes on the web.

Straight from the app, a note becomes a public page. Links between published notes keep working, and the pages are made to show up in search.

### From a note to the web

You publish from Niv, with nothing to export. The page is your note.

### Links keep working

A `[[link]]` to another published note becomes a real link on the page.

### Made to be found

Every page comes out ready for search engines.

## When your notes become the team’s place to work.

Niv is free, for you and up to two more people in a Space. Pro is for the Spaces that grow: more people, databases you build, and room for your files.

### Price

- Free: $0.
- Niv Pro, yearly: $95.99 a year ($8 a month, 33% less than paying by the month).
- Niv Pro, monthly: $11.99 a month.

At checkout you pay in reais in Brazil and in US dollars everywhere else.

### Everyone you work with

Free Spaces hold up to three people. With Pro, invite as many as you need.

### Databases you build

Anyone can open and read a database. With Pro you create them, edit rows and export: up to 20 per Space, 1 GB each.

### Room for your files

50 GB for images and attachments, where Free has 2 GB.

## Before you download

Short answers to what people ask first.

### Is Niv free?

Yes. The app, sync across your devices, writing together in a shared Space and publishing a note to the web cost nothing.

### Does my Obsidian vault work in Niv?

Yes. Choose the vault’s folder and your notes open where they are, with their [[links]], backlinks and graph. Niv never writes to .obsidian and runs none of Obsidian’s plugins, so the same files still open in Obsidian.

### Which devices does Niv run on?

On Mac (macOS 13 Ventura or later, Apple silicon or Intel) and on Windows 10 or later, 64-bit. On Linux, niv keeps your notes in sync from the terminal. The Linux app, iPhone, iPad and Android have a waitlist.

### Where are my notes kept?

In a folder you choose, as plain Markdown files. Sign in and they also sync to your Space and across your devices; you can start offline and sign in later. A note you keep local only never leaves your device.

### Which AI agents work with Niv?

The one you already use: Claude Code, Codex, Cursor, OpenCode, Grok or Antigravity, installed on your computer and signed in with your own account. Niv’s chat runs it on your notes, with the access level you choose.

### Can I publish notes and invite people?

Yes. Turn a note, or a whole folder, into public web pages from the app, and invite people to a Space by email from the Space’s settings, under People. The Space’s owners and editors can do both.

## Start with your first note.

Free: the app, sync across your devices, and real-time writing with whoever you invite.

[Download Niv for macOS](https://releases.niv.md/desktop/latest/Niv.dmg). Opens the Markdown folder you already have, including an Obsidian vault.

---

More: [Niv](https://niv.md/) · [About](https://niv.md/about) · [Contact](https://niv.md/contact) · [Privacy](https://niv.md/privacy) · [Encryption](https://niv.md/encryption) · [Terms](https://niv.md/terms) · [llms.txt](https://niv.md/llms.txt) · [Português (Brasil)](https://niv.md/pt-br)
