Notamos CLI

Notamos desde Terminal

El CLI es la alternativa para clientes sin OAuth y una herramienta de diagnóstico e instalación de skills. En Codex, la conexión recomendada es OAuth y no requiere Terminal.

Antes de instalar: Codex no necesita CLI

En Codex agrega https://notamos.app/api/mcp como servidor Streamable HTTP, pulsa Authenticate y elige un workspace. No necesitas Node, PowerShell ni copiar una clave. Usa el CLI solamente para instalar skills explícitamente, diagnosticar el equipo o conectar un cliente que aún dependa de STDIO.

Instalar

npm install -g @notamos/cli
notamos --version

Requiere Node.js 18 o superior.

Conectar por STDIO (alternativa manual)

Ejecuta notamos connect para abrir la guía. En la alternativa manual crea una credencial, copia el comando de tu sistema y pégalo en Terminal sin ejecutarlo; vuelve a Notamos, copia la clave y finalmente regresa a Terminal para presionar Enter:

Windows PowerShell

Get-Clipboard | notamos setup --token-stdin --client codex

macOS

pbpaste | notamos setup --token-stdin --client codex

Linux con xclip

xclip -selection clipboard -o | notamos setup --token-stdin --client codex

Sustituye codex por claude-code cuando corresponda. Para otro cliente, usa notamos mcp configure --token-stdin en lugar de setup y después ejecuta notamos mcp print-config.

Verificar y diagnosticar

notamos mcp status
notamos doctor --client codex
notamos mcp print-config
notamos skills status --client codex

Con STDIO, mcp status comprueba la credencial y lista las herramientas. Con OAuth, reconoce la configuración de Codex sin intentar extraer su token. print-config genera la configuración STDIO para otros clientes y nunca imprime tu clave.

Codex Desktop en Windows

notamos setup --client codex configura la aplicación gráfica aunque no exista el comando codex. Si el diagnóstico todavía marca el cliente con error, revisa estos valores:

Comando
C:\Program Files\nodejs\npx.cmd
Argumentos separados
-y · @notamos/cli@latest · mcp · serve
Directorio
Vacío o la carpeta del usuario; no uses ~/code en Windows.
(Get-Command npx.cmd).Source
notamos skills install --client codex

Cierra Codex también desde la bandeja del sistema, vuelve a abrirlo y usa una conversación nueva. “Autenticación no admitida” es normal en STDIO.

Skills

El paquete incluye guías, flashcards, quizzes y presentaciones citadas. La generación sucede en tu agente y el MCP permanece read-only.

notamos skills list
notamos skills install --client codex
notamos skills status --client codex
notamos skills update --client codex

Usa --client claude-code para Claude Code. El instalador no sobrescribe copias modificadas; --force las reemplaza y debe usarse de forma deliberada.

Capture local

Con Capture abierto, el CLI descubre su bridge privado en loopback.

notamos notes list --json
notamos notes search "Proyecto Faro"
notamos notes get 42
notamos folders list
notamos transcriptions list
notamos health

Automatización y salida

Agrega --json para stdout estructurado. En servidores headless usa NOTAMOS_MCP_TOKEN desde un gestor de secretos; nunca guardes la clave en git.

notamos mcp logout
npm install -g @notamos/cli@latest
npm uninstall -g @notamos/cli

Al desconectar un equipo, revoca también su credencial en Configuración.