Notezbeta
Voltar ao blog

Capture anotações de qualquer lugar: CLI, MCP e captura rápida

ProductivityDenis Povarov

O problema mais difícil das anotações não é a organização. São os três segundos entre ter uma ideia e ter onde colocá-la. Se esses três segundos se perdem com frequência, você acaba parando de anotar de vez.

O Notez ataca isso por seis frentes.

1. A CLI

Se você vive no terminal, este é o caminho mais rápido que existe.

Bash 
notez "postgres connection pool exhausted under load — check pgbouncer config"

A interação é só essa. A nota está no seu espaço de trabalho antes de as suas mãos saírem do teclado.

Passe o caminho de um arquivo e ela envia o arquivo:

Bash 
notez ./architecture-diagram.png

O conjunto de comandos é pequeno de propósito:

Comando

O que faz

notez "text"

Salva o texto como uma nota

notez ./file

Envia um arquivo

notez login

Autoriza este terminal

notez logout

Apaga a chave da CLI guardada

notez update

Instala a versão mais recente

Duas flags: --title para definir o título, e --json para imprimir a nota criada como JSON — útil para passar o resultado a outras ferramentas por pipe. A CLI também recebe entrada por pipe, então git log --oneline -10 | notez --title "Release commits" funciona.

A CLI só captura. Não existe list, search, edit nem delete. É intencional: é um binário nativo pequeno cujo único trabalho é nunca fazer você esperar. Instale no macOS ou Linux (no Windows, execute iwr -useb https://notez.dev/install.ps1 | iex no PowerShell):

Bash 
curl -fsSL https://notez.dev/install.sh | sh

Depois execute notez login uma vez em cada máquina.

2. MCP — seu assistente de IA escreve nas suas notas

O Notez roda um servidor Model Context Protocol, o que significa que o Claude Code, o Claude Desktop, o Cursor e o Windsurf conversam direto com o seu espaço de trabalho.

O Claude, o Claude Code, o ChatGPT e o VS Code se conectam entrando na sua conta do Notez. Para o Cursor, o Windsurf ou um script, o proprietário do espaço de trabalho gera uma chave em Configurações → Integrações → Servidor MCP do Notez, e a página entrega um comando pronto para colar, com o seu endpoint e o seu token já preenchidos.

Com uma chave, seu assistente ganha 31 ferramentas: ele lê, busca, cria, edita, renomeia, move, aplica tags, apaga (para a lixeira) e restaura notas, e envia arquivos. Entrar com Leitura e escrita dá 32, com list_workspaces a mais; Somente leitura dá 14.

O efeito prático é que você termina uma sessão de debug com "escreva o que acabamos de descobrir numa nota com a tag postgres" e pronto — em vez de a conclusão evaporar quando você fecha a aba.

Duas coisas que vale saber. Cada chave MCP fica vinculada a um único espaço de trabalho, então uma chave do seu espaço de trabalho profissional não vê suas notas pessoais. E uma conexão feita ao entrar na conta alcança todos os espaços de trabalho de que você participa.

3. Digite em qualquer tela

Abra o app web, não clique em nada e simplesmente comece a digitar. As letras vão direto para a busca — porque na maior parte do tempo você está procurando algo que já escreveu.

Mas, se não for o caso, aperte ↵. A lista de sugestões destaca Criar nota "..." por padrão, então o Enter salva o que você digitou como uma nova nota — a busca já rodou enquanto você digitava, e a linha de status acima das sugestões mostra o que ela encontrou. ⌘↵ faz o mesmo sem as sugestões. Toda captura mostra um aviso com Desfazer e Abrir.

Isso funciona em todas as páginas do app, menos na tela de detalhe da nota e na tela de autorização da CLI, onde digitar obviamente significa outra coisa.

4. Captura da área de transferência

⌘V sem nada em foco salva a área de transferência como uma nota na hora — sem janela nenhuma. Texto vira nota, uma URL sozinha vira link salvo, e arquivos ou imagens viram uma nota com os arquivos anexados. Copie uma captura de tela de qualquer lugar, aperte ⌘V, pronto; o Desfazer está a um clique no aviso.

Imagens coladas direto no editor durante a escrita são enviadas ali mesmo, comprimidas automaticamente.

5. Captura de URL

Cole uma URL sozinha como nota rápida e o Notez a reconhece: salva como uma nota do tipo link salvo, com a URL guardada, em vez de um bloco de texto. Um "ler depois" sem um segundo app.

Vale alinhar as expectativas: nada é buscado na página. Sem prévia, sem favicon, sem busca de título — só um registro limpo e privado do link. E a URL precisa do prefixo https:// para ser reconhecida como URL.

6. Captura rápida no app

⌘E abre uma nova nota de qualquer lugar. ⌘↵ salva.

Num quadro, o cartão de adição rápida recebe o texto direto na coluna — ↵ salva, ⇧↵ adiciona uma nova linha, Esc cancela.

De onde veio esta nota?

Como há tantas entradas, o Notez marca com um selo as notas que chegaram de algum lugar que não o próprio app: a CLI, o MCP, a API, o chat de IA, um webhook, uma captura de URL ou uma importação. A captura pelo Telegram não existe mais, mas as notas salvas por ela mantêm o selo do Telegram.

É um detalhe pequeno que se mostra útil de verdade. Você descobre que suas melhores ideias chegam pela CLI às 23h, ou que tudo o que vem do MCP precisa de uma passada de limpeza. O atrito da captura é invisível até você conseguir vê-lo.

O que importa

Nenhum desses recursos impressiona sozinho. Juntos, eles fazem a resposta para "onde eu coloco isso?" ser sempre a mesma: onde você já está. A organização pode vir depois — com tags, subnotas, quadros e propriedades — e encontrar a nota depois é o papel do chat de IA e da busca híbrida.

O único passo que precisa ser livre de atrito é o primeiro.

Continue lendo