Usar Grape desde la terminal y tus agentes de IA

Antes de empezar

• Una cuenta de Grape en Pro, con la sesión iniciada con la misma cuenta de Google que usas en las apps de Grape.
• La sincronización activada en la app, porque la CLI trabaja con las notas de tu cuenta.
• Node.js 20 o posterior en tu Mac, Windows o Linux. Si node --version no encuentra nada, instálalo desde nodejs.org.

Instalarla

Abre una terminal y ejecuta:

npm install -g @grapecool/cli

Eso agrega el comando grape. grape --version dice qué versión tienes y grape --help muestra todos los comandos. Para probarla sin instalar nada, escribe npx @grapecool/cli donde estos ejemplos dicen grape.

Iniciar sesión

Ejecuta grape login. Tu navegador abre grape.cool: inicia sesión con Google, revisa que la página nombre tu cuenta y elige Permitir. La terminal termina sola y dice con qué cuenta inició sesión, y grape whoami lo vuelve a decir cuando quieras.

En una computadora sin navegador, como un servidor, ejecuta grape login --no-browser, abre en cualquier dispositivo la dirección que muestra y, después de Permitir, pega en la terminal la dirección donde termina el navegador.

La sesión queda en esa computadora y se renueva sola, así que esto se hace una sola vez.

Probarla

Cada nota y cada carpeta tiene un id, el número largo que muestran las listas, y los demás comandos lo usan.

grape notes list
grape notes search "reunión"
grape notes get 4821930571234
grape notes create "# Llamar al dentista"
grape notes append 4821930571234 "- Llevar las diapositivas"
grape folders list

Una nota se escribe en markdown. La primera línea es su título, así que empieza con un encabezado. Una palabra que empieza con # se convierte en una etiqueta, y [[Título de la nota]] se convierte en un enlace entre notas. El texto también puede venir de un archivo con --file, o directo de otro comando: pbpaste | grape notes create hace una nota con lo que copiaste en una Mac.

La CLI responde en inglés, aunque tus notas pueden estar en cualquier idioma.

Usarla con un agente de IA

Un agente de IA que trabaja en tu terminal puede ejecutar grape por ti. Instala la CLI e inicia sesión una vez, y luego pídele con tus propias palabras:

• "Guarda un resumen de lo que hicimos hoy en mi carpeta Trabajo de Grape."
• "Busca mis notas sobre el plan del Q3 y dime qué decidimos."
• "Agrega estas tareas a mi nota de la reunión del lunes."
• "Haz una nota de Grape con la lista de pasos para publicar este proyecto."
• "Lee mi nota Entrevista con Dana y escribe un borrador del correo de seguimiento."

El agente aprende los comandos con grape --help. Cada comando también imprime JSON con --json, que es lo que mejor leen los agentes, y cuando la sesión se vence el agente recibe el código de salida 3 y te pide que vuelvas a ejecutar grape login.

Ideas para scripts

• Empieza cada día desde tu plantilla: grape notes create --file ~/diario.md desde cron o un atajo.
• Guarda lo que imprimió un comando: (echo "# Commits de ayer"; git log --oneline --since=yesterday) | grape notes create.
• Guarda una lista de todas tus notas en JSON: grape notes list --all --json > notas.json.
• Responde una pregunta sobre Grape sin cuenta: grape guides search "la sincronización no funciona".

Qué puede hacer y qué no

Usa las mismas doce herramientas que la conexión para ChatGPT y Claude, con los mismos límites. Eliminar mueve la nota a Eliminados Recientemente, donde puedes restaurarla durante 30 días. Una nota bloqueada nunca se lista, se lee ni se cambia. No puede agregar imágenes ni archivos, editar notas de escritura a mano ni llegar a los dibujos, tarjetas de memoria, presentaciones y demás bloques que hay dentro de una nota. grape notes get muestra esos bloques como líneas de marcador, y grape notes replace se detiene si tu texto nuevo quitaría alguno. Una cuenta puede hacer 600 llamadas por hora.

Cuándo ves los cambios

Una nota que escribe la CLI llega a tus dispositivos como cualquier cambio sincronizado: cuando la app se abre, cuando vuelves a ella, cada quince minutos, o de inmediato con Sincronizar ahora en la pestaña Sincronización en la nube de Configuración.

Cerrar sesión

grape logout quita la sesión de esa computadora. Una sesión que no se usa durante 90 días termina sola, y terminar tu plan Pro también la termina.