---
title: "Niv CLI"
description: "niv é a linha de comando do Niv para Mac, Linux e Windows: instale com o Homebrew ou uma linha, e sincronize uma pasta de notas Markdown com um Space, publique notas e trabalhe com bancos de dados pelo terminal, por um script ou por um agente de IA."
canonical: https://niv.md/pt-br/cli
language: pt-BR
last_updated: 2026-11-14T17:16:54.000Z
---

# Niv CLI

niv é a linha de comando do Niv. Mantém uma pasta de notas Markdown sincronizada com um Space do mesmo jeito que o app do Niv, cifrada de ponta a ponta em todo Space criado agora. Use num servidor, num script, por um agente de IA, ou onde você preferir não abrir o app. É grátis, como a sincronização.

## Instalar

No Mac, com o Homebrew. No Linux e no Windows, uma linha. niv --version diz qual versão você tem; niv upgrade atualiza.

- macOS (Homebrew): `brew install niv-md/tap/niv`
- Linux: `curl -fsSL https://releases.niv.md/install.sh | sh`
- Windows (PowerShell): `irm https://releases.niv.md/install.ps1 | iex`

A fórmula do Homebrew é pública, no tap do Niv no GitHub: [niv-md/homebrew-tap](https://github.com/niv-md/homebrew-tap).

## Comece em quatro linhas

1. `niv sign-in`: Deixa este computador entrar como um dispositivo da sua conta. Você aprova e digita a sua frase de criptografia.
2. `cd ~/notes`: Vá para a pasta que você quer sincronizar.
3. `niv connect`: Pergunta com qual Space a pasta sincroniza.
4. `niv`: Sozinho, abre a visão ao vivo. Aperte q para parar. niv sync faz o mesmo sem tela.

## Os comandos

### Começar

- `niv sign-in`: Deixa este computador entrar como um dispositivo da sua conta
- `niv connect`: Sincroniza esta pasta com um Space

### Manter rodando

- `niv sync`: Mantém esta pasta sincronizada, sem a visão ao vivo
- `niv status`: Como vai a sincronização desta pasta
- `niv holds`: Arquivos esperando a sua escolha

### Publicar

- `niv publish`: Publica uma nota como página web, ou atualiza a página dela
- `niv unpublish`: Tira a página de uma nota do ar
- `niv published`: As páginas públicas deste Space

### Este dispositivo

- `niv device`: Nome e impressão digital
- `niv spaces`: Os seus Spaces
- `niv disconnect`: Para de sincronizar esta pasta
- `niv stores`: Os dados de sincronização que o niv guarda neste computador
- `niv sign-out`: Remove as chaves deste dispositivo
- `niv upgrade`: Atualiza o niv para a versão mais nova

### Para agentes

- `niv skill`: Como um agente de IA deve usar o niv
- `niv databases`: Lista, lê e altera os bancos de dados de um Space
- `niv mcp`: Deixa um app de IA ler as notas desta pasta, e ler e alterar os bancos de dados de um Space

## Para scripts e agentes

Todo comando aceita --folder <path> (ou NIV_FOLDER) e --json, que imprime JSON na saída padrão. niv help <command> lista as opções de um comando. niv skill imprime uma skill escrita para a versão que você tem, para um agente de IA ler.

niv mcp é um servidor MCP local para apps como Claude Code, Cursor e Claude Desktop: [Servidor MCP do Niv](https://niv.md/pt-br/mcp).

O guia completo está na documentação: [Niv Docs](https://niv.md/docs). [O que mudou em cada versão do niv](https://niv.md/pt-br/changelog/cli).

---

Mais: [Niv](https://niv.md/pt-br) · [Sobre](https://niv.md/pt-br/about) · [Contato](https://niv.md/pt-br/contact) · [Privacidade](https://niv.md/pt-br/privacy) · [Criptografia](https://niv.md/pt-br/encryption) · [Termos](https://niv.md/pt-br/terms) · [llms.txt](https://niv.md/llms.txt) · [English](https://niv.md/cli)
