Notezbeta
Voltar ao blog

Primeiros passos com a Notez CLI

terminalDenis Povarov

A Notez CLI é um binário nativo de 3 MB que captura notas a partir do seu shell. Sem runtime do Node, sem daemon, sem arquivo de configuração para escrever à mão — você instala, autoriza o terminal uma vez e, a partir daí, notez "sua ideia" leva a ideia para o seu espaço de trabalho. Funciona no macOS, Linux e Windows.

Este guia cobre a instalação, a primeira configuração e as poucas flags que vale a pena conhecer.

Instalação

No macOS ou Linux:

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

O script baixa o binário mais recente para a sua plataforma, confere o checksum SHA256 e coloca o notez em /usr/local/bin (ou em ~/.local/bin, se não houver permissão de escrita ali).

No Windows, no PowerShell:

powershell 
iwr -useb https://notez.dev/install.ps1 | iex

Isso instala em %LOCALAPPDATA%\Programs\notez e adiciona a pasta ao PATH do seu usuário.

Se você prefere não mandar um script direto para o shell — um instinto razoável —, os binários ficam disponíveis em https://notez.dev/downloads/cli/ para macOS (arm64 e x64), Linux (x64 e arm64) e Windows, cada um com um arquivo .sha256 ao lado para conferência manual. Extraia o arquivo compactado e coloque o notez em qualquer pasta do seu $PATH.

Um detalhe no macOS: se você baixar o tarball pelo navegador em vez do curl, o Gatekeeper o coloca em quarentena. Remova o atributo uma vez com xattr -d com.apple.quarantine /path/to/notez.

Autorizando o terminal

Bash 
notez login

Isso abre o navegador em notez.dev/cli-auth, onde você escolhe um espaço de trabalho do qual é proprietário e aprova o terminal; só o proprietário de um espaço de trabalho pode configurar a CLI para ele. Uma chave de API de longa duração, válida só para esse espaço de trabalho e limitada a criar notas e enviar arquivos, é gerada e guardada localmente:

  • macOS: ~/Library/Application Support/notez/config.toml

  • Linux: ~/.config/notez/config.toml

  • Windows: %APPDATA%\notez\config.toml

Você pode revogar a chave a qualquer momento em Configurações → Integrações → Notez CLI — útil se você perder o notebook ou se uma máquina compartilhada precisar perder o acesso. notez logout apaga a chave da máquina local.

Capturando notas

O caminho principal é um comando só:

Bash 
notez "retry storm happens when the circuit breaker resets too early"

O texto vira uma nota no seu espaço de trabalho e já aparece na busca. Algumas variações cobrem o resto do uso diário:

Bash 
# Pipe output into a note
grep -c ERROR app.log | notez

# Give the note an explicit title (otherwise the text is used)
notez --title "Incident 2026-08-30" "db failover took 40s, alarms fired late"

# Capture a URL — auto-detected and stored as a bookmark
notez "https://docs.anthropic.com/quickstart"

# Upload a file — a path that exists is detected and uploaded
notez ./architecture-diagram.png

Vale destacar o pipe. Tudo o que o seu shell produz — a saída de um teste que falhou, um stack trace, a combinação de flags que finalmente funcionou — pode ser capturado no momento em que está na tela, sem selecionar texto nem trocar de janela.

Scripts com --json

notez --json "..." imprime a nota criada como JSON, e assim a CLI se combina com outras ferramentas. Dois padrões práticos:

Bash 
# Capture and keep the note id for later reference
NOTE_ID=$(notez --json "deploy checklist for v2.3" | jq -r .id)

# A git hook that logs every release
notez "released $(git describe --tags) to production"

Por ser um único binário rápido, a CLI cabe em lugares onde ferramentas mais pesadas não cabem: dentro de jobs de CI, em servidores remotos via SSH, num painel do tmux que você deixa aberto ao lado do editor.

Para onde vão as notas

Tudo o que a CLI captura cai no mesmo cofre que as outras entradas do Notez — o painel web, a captura pela barra de endereços com notez.dev/sua ideia e as ferramentas de IA conectadas via MCP. No app web você navega e busca nas capturas, adiciona tags, cria links para outras notas ou transforma uma captura crua num documento estruturado com o editor completo.

A busca do Notez funciona por significado, não só por palavras-chave, então uma captura curta como notez "paginação por cursor é melhor que offset em tabelas grandes" aparece depois numa busca por "desempenho da paginação" — mesmo sem você ter adicionado tag nem arquivado a nota.

Um fluxo de trabalho que dura

O hábito que faz a CLI valer a pena é baixar a régua do que merece uma nota. Com um app de notas que leva vinte segundos para abrir, só pensamentos importantes passam, e a maioria dos pequenos — a solução de contorno, a flag, a ideia pela metade — evapora. Com a captura em dois segundos, tudo passa.

Alguns hábitos que vale a pena copiar:

  • Anote a correção, não só o bug. No momento em que algo finalmente funciona, registre o motivo com notez "...". Lá na frente, diante do mesmo erro, você vai procurar por ele.

  • Registre as decisões na hora. Uma linha sobre por que você escolheu a abordagem A em vez da B é melhor do que reconstruir isso depois, na revisão de um design doc.

  • Use pipe, não cole. Se já está no terminal, | notez é mais rápido e mais preciso do que copiar e colar numa interface gráfica.

Solução de problemas

Se o notez login avisar que não foi possível acessar a CLI no seu computador, provavelmente a troca de autorização expirou — execute notez login de novo. Se uma chave parar de funcionar, confira Configurações → Integrações → Notez CLI: revogar um terminal ali o desativa na hora, e executar notez login de novo nessa máquina gera uma chave nova.

A ferramenta é só isso. notez --help lista tudo, notez update instala a versão mais recente no lugar da atual, mas o resumo honesto é: um comando, a sua ideia, pronto.

Continue lendo