Notezbeta
Volver al blog

Primeros pasos con Notez CLI

terminalDenis Povarov

Notez CLI es un binario nativo de 3 MB que captura notas desde tu shell. Sin runtime de Node, sin daemon, sin archivo de configuración que escribir a mano: lo instalas, autorizas la terminal una vez y, a partir de ahí, notez "your thought" deja la idea en tu espacio de trabajo. Funciona en macOS, Linux y Windows.

Esta guía recorre la instalación, la configuración inicial y los pocos flags que vale la pena conocer.

Instalación

En macOS o Linux:

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

El script descarga el último binario para tu plataforma, verifica su checksum SHA256 y coloca notez en /usr/local/bin (o en ~/.local/bin si en la primera carpeta no se puede escribir).

En Windows, en PowerShell:

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

Esto lo instala en %LOCALAPPDATA%\Programs\notez y lo añade al PATH de tu usuario.

Si prefieres no pasarle un script por pipe a tu shell — un instinto razonable —, los binarios se sirven directamente desde https://notez.dev/downloads/cli/ para macOS (arm64 y x64), Linux (x64 y arm64) y Windows, cada uno con su archivo .sha256 al lado para verificarlo a mano. Extrae el archivo comprimido y pon notez en cualquier carpeta de tu $PATH.

Una nota sobre macOS: si descargas el tarball con el navegador en lugar de con curl, Gatekeeper lo pone en cuarentena. Quita el atributo una sola vez con xattr -d com.apple.quarantine /path/to/notez.

Autorizar tu terminal

Bash 
notez login

El comando abre el navegador en notez.dev/cli-auth, donde eliges un espacio de trabajo del que eres propietario y apruebas la terminal; solo el propietario de un espacio de trabajo puede configurar la CLI para él. Se genera una clave de API de larga duración, limitada a ese espacio de trabajo y a crear notas y subir archivos, y se guarda en local:

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

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

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

Puedes revocar la clave en cualquier momento en Configuración → Integraciones → Notez CLI, por ejemplo si pierdes tu equipo o si una máquina compartida ya no debe tener acceso. notez logout borra la clave guardada en tu equipo.

Capturar notas

El camino principal es un solo comando:

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

El texto se convierte en una nota de tu espacio de trabajo y se puede buscar al instante. Unas cuantas variantes cubren el resto del uso diario:

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 la pena insistir en la forma con pipe. Todo lo que tu shell puede producir — la salida de un test que falla, un stack trace, la combinación de flags que por fin funcionó — se captura en el momento en que está en pantalla, sin seleccionar texto ni cambiar de ventana.

Usar la CLI en scripts con --json

notez --json "..." imprime la nota creada como JSON, así que la CLI se combina con otras herramientas. Un par de patrones prácticos:

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"

Como es un único binario rápido, la CLI encaja donde las herramientas más pesadas estorban: dentro de jobs de CI, en servidores remotos por SSH, en un panel de tmux que tienes abierto junto al editor.

Adónde van las notas

Todo lo que captura la CLI llega a la misma bóveda que las demás formas de usar Notez: el panel web, la captura desde la barra de direcciones con notez.dev/your thought y cualquier herramienta de IA conectada por MCP. En la app web exploras y buscas lo capturado, le añades etiquetas, lo enlazas con otras notas o conviertes una captura en bruto en un documento estructurado con el editor completo.

La búsqueda de Notez funciona por significado, no solo por palabras clave, así que una captura escueta como notez "cursor pagination beats offset for big tables" aparece más tarde al buscar "pagination performance", aunque nunca la etiquetaras ni la archivaras.

Un flujo de trabajo que dura

El hábito que hace rentable la CLI es bajar el listón de lo que merece una nota. Con una app de notas a la que se tarda veinte segundos en llegar, solo superan el listón las ideas importantes, y la mayoría de las pequeñas — el workaround, el flag, la idea a medio formar — se evaporan. Con capturas de dos segundos, todo lo supera.

Unos cuantos hábitos que vale la pena copiar:

  • Captura el arreglo, no solo el bug. En cuanto algo por fin funciona, guarda el motivo con notez "...". Dentro de unos meses, ante el mismo error, lo buscarás.

  • Registra las decisiones en el momento. Una línea sobre por qué elegiste el enfoque A en lugar del B es mejor que reconstruirlo después, en la revisión de un documento de diseño.

  • Usa pipes, no pegues. Si ya está en tu terminal, | notez es más rápido y más exacto que copiar y pegar en una interfaz gráfica.

Solución de problemas

Si notez login indica que no pudo comunicarse con la CLI de tu máquina, seguramente se agotó el tiempo del intercambio de autorización: vuelve a ejecutar notez login. Si una clave deja de funcionar, revisa Configuración → Integraciones → Notez CLI: revocar una terminal ahí la desactiva al instante, y volver a ejecutar notez login en esa máquina emite una clave nueva.

Eso es toda la herramienta. notez --help lo lista todo y notez update instala la última versión encima de la actual, pero el resumen honesto es: un comando, tu idea, listo.

Sigue leyendo