Workflowy CLI

Workflowy CLI (wf) es un conjunto de herramientas de línea de comandos de código abierto para leer, buscar, organizar y editar tu cuenta de Workflowy. Incluye un caché local para un acceso rápido, comandos de automatización, resultados legibles por máquinas para scripts y agentes, y un servidor MCP integrado.

Puedes encontrar el código fuente y las versiones más recientes en el repositorio de GitHub de Workflowy CLI.

Lo que puedes hacer

• Leer y buscar en tu cuenta de Workflowy desde una terminal
• Agregar, actualizar, mover, completar y eliminar nodos
• Trabajar con ubicaciones integradas como @inbox, @today y @tomorrow
• Usar marcadores y rutas para dirigirte a partes concretas de tu cuenta
• Exportar esquemas, buscar tareas pendientes y etiquetas, y revisar cambios recientes
• Conectar varias cuentas de Workflowy y mantener un caché local independiente para cada una
• Devolver JSON estructurado para scripts y agentes de IA
• Conectar herramientas de IA compatibles con MCP directamente con Workflowy

Lo que necesitas

• Una clave API de Workflowy de workflowy.com/api-key
• Una terminal en macOS, Linux o Windows

Cómo instalarlo

macOS y Linux

Copia y pega este comando en tu terminal:

curl -fsSL https://github.com/rodolfo-terriquez/workflowy-cli/releases/latest/download/install.sh | bash

Windows

Copia y pega este comando en PowerShell:

irm https://github.com/rodolfo-terriquez/workflowy-cli/releases/latest/download/install.ps1 | iex

El instalador detecta tu sistema operativo y procesador, descarga la versión precompilada más reciente y agrega el comando wf a tu PATH cuando es posible.

Conectar tu cuenta de Workflowy

Ejecuta estos comandos después de la instalación:

wf login
wf cache:sync
wf doctor

wf login solicita tu clave API de Workflowy sin mostrarla. wf cache:sync descarga una copia local de tu esquema para realizar lecturas y búsquedas rápidas. wf doctor comprueba el inicio de sesión, la configuración, el caché y la instalación.

Empezar a usar la CLI

Lee una ubicación o busca en tu cuenta:

wf node:read @inbox
wf node:read @today --depth 3
wf search "quarterly planning"
wf targets

Agrega y administra elementos:

wf node:add @inbox "Draft project brief" --type todo
wf node:complete "@inbox/Draft project brief"
wf node:move "@today/Review roadmap" @inbox
wf node:update "@inbox/Follow up" --note "Waiting on a reply"

Los comandos que aceptan un destino pueden usar una ubicación integrada, un marcador devuelto por wf targets, un ID de nodo o una ruta como @today/Meetings/Launch review.

Ejecuta wf --help para ver la lista completa de comandos o agrega --help después de un comando para consultar sus opciones.

Mantener actualizados los resultados locales

La mayoría de los comandos de lectura y búsqueda usan automáticamente el caché local de SQLite. Sincronízalo cuando quieras obtener la copia más reciente de tu cuenta de Workflowy:

wf cache:sync

Para una solicitud puntual que deba omitir el caché, usa --live en los comandos compatibles:

wf node:read @inbox --live
wf search "launch notes" --live

Conectar varias cuentas

Asigna a cada cuenta un nombre local corto al iniciar sesión:

wf login --account personal
wf login --account work
wf account:list
wf account:switch work
wf account:current

Cada cuenta mantiene su propio caché local. Puedes seleccionar una cuenta para un solo comando sin cambiar la predeterminada:

wf --account personal cache:sync
wf --account work node:add @inbox "Follow up with the team"

Usar la CLI con scripts y agentes de IA

Agrega --agent para devolver JSON legible por máquinas con resultados y errores estructurados:

wf search "project roadmap" --agent
wf node:read @today --depth 3 --agent

La CLI también incluye un servidor MCP local:

wf mcp

Configura tu cliente MCP para que ejecute el binario wf instalado con el argumento mcp. Ejecuta primero wf login y wf cache:sync para que el servidor pueda usar la misma cuenta y el mismo caché que la CLI. Consulta el README de Workflowy CLI para ver ejemplos de configuración y opciones avanzadas de MCP.

Actualizar la CLI

Comprueba si hay una nueva versión o instala una con:

wf self:update --check
wf self:update

Seguridad y solución de problemas

• Usa la solicitud interactiva de wf login para que tu clave API no se guarde en el historial del shell.
• Si los resultados de búsqueda parecen desactualizados, ejecuta wf cache:sync o usa --live.
• Si un comando utiliza la cuenta incorrecta, comprueba wf account:current y cambia de cuenta con wf account:switch <name>.
• Si no se encuentra wf después de la instalación, abre una terminal nueva y comprueba que el directorio de instalación esté en tu PATH.
• Ejecuta wf doctor para comprobar la instalación, autenticación, configuración y caché.
• Para informar errores o solicitar funciones, visita las incidencias de GitHub del repositorio.