---
{
  "title": "Workflowy CLI",
  "intro": "Usa Workflowy desde tu terminal, scripts y agentes de IA."
}
---

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](https://github.com/rodolfo-terriquez/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](https://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:

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

## Windows

Copia y pega este comando en PowerShell:

```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:

```bash
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:

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

Agrega y administra elementos:

```bash
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:

```bash
wf cache:sync
```

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

```bash
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:

```bash
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:

```bash
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:

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

La CLI también incluye un servidor MCP local:

```bash
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](https://github.com/rodolfo-terriquez/workflowy-cli#readme) 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:

```bash
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](https://github.com/rodolfo-terriquez/workflowy-cli/issues) del repositorio.