@notamos/cli

CLI oficial de Notamos. Conecta Claude Code, Codex y otros clientes MCP con tus workspaces, y conserva los comandos históricos que operan la app Capture por su bridge local.

Requisitos

• Node.js 18 o superior.
• Una cuenta Notamos con el piloto MCP habilitado.
• Para los comandos locales: Notamos Capture abierto.

Instalar

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

También puedes usarlo sin instalación global:

npx -y @notamos/cli@latest connect

Conectar un agente

1. Abre Configuración y crea una conexión MCP. La clave se muestra una vez.
2. Cópiala y deja que el CLI la lea por stdin, sin escribirla en el historial:

pbpaste | notamos mcp configure --token-stdin

El instalador detecta Claude Code y Codex, registra un servidor notamos, instala los cuatro skills académicos por usuario y guarda la credencial en ~/.notamos/mcp.json con permisos 0600. Las configuraciones de terceros solo contienen el comando del puente; nunca una copia del token.

notamos mcp status       # valida la clave y lista las herramientas
notamos mcp print-config # JSON para otro cliente stdio
notamos mcp logout       # borra la copia local; revoca también en la web

Para seleccionar clientes explícitamente:

pbpaste | notamos mcp configure --token-stdin --client claude-code codex

Skills incluidos

• notamos-study-guide: guías con objetivos, conceptos, práctica y fuentes.
• notamos-flashcards: tarjetas deduplicadas para active recall.
• notamos-quiz: quizzes, rúbricas, corrección y citas.
• notamos-study-presentation: slides con speaker notes y fuentes.

Los artifacts visuales creados por estos workflows usan la identidad Notamos: paleta cream/sage, logo oficial y atribución “Creado con Notamos”. La marca se omite en TSV, CSV, JSON y formatos de importación para preservar su esquema.

notamos skills list
notamos skills install [--client claude-code codex]
notamos skills status
notamos skills update

La instalación es atómica y no sobrescribe una copia modificada o un skill ajeno con el mismo nombre. --force reemplaza esos cambios deliberadamente. Los skills usan el MCP read-only: el agente externo genera el resultado con la cuenta del usuario y todavía no lo guarda como artifact dentro de Notamos.

En servidores sin portapapeles puedes pasar la clave por stdin desde tu gestor de secretos. NOTAMOS_MCP_TOKEN y NOTAMOS_MCP_URL existen como overrides de automatización; no pongas la clave directamente en un comando ni en git.

Qué puede leer MCP

El servidor es read-only: perfil del workspace, cursos, notas, búsqueda, transcripciones paginadas, tareas y momentos. Notamos entrega datos y citas; el agente conectado realiza la síntesis con la cuenta del usuario.

Capture local

Estos comandos siguen usando el bridge HTTP loopback de la app de escritorio:

notamos notes list [--type <t>] [--limit <n>] [--folder <id>] [--json]
notamos notes get <id> [--json]
notamos notes search <texto...> [--limit <n>] [--json]
notamos notes create --title <t> [--content <c>] [--type <t>] [--folder <id>]
notamos notes edit <id> [--title <t>] [--content <c>] [--type <t>]
notamos notes delete <id>
notamos folders list
notamos folders create <name>
notamos transcriptions list [--limit <n>]
notamos transcriptions get <id>
notamos transcriptions delete <id>
notamos transcriptions delete-audio <id>
notamos health

Agrega --json para obtener salida apta para scripts.

Seguridad y solución de problemas

• Revoca una conexión desde Configuración si un equipo se pierde o una clave se expone. Borrar el archivo local no revoca el grant remoto.
• 401: crea una clave nueva y vuelve a ejecutar mcp configure.
• Sin herramientas: reinicia por completo Claude Code o Codex y ejecuta notamos mcp status.
• Capture no encontrado: abre la app de escritorio antes de usar comandos locales.

Licencia

MIT