Presentamos Quire CLI: gestión de proyectos desde tu terminal

Resumen
Quire CLI es la herramienta de línea de comandos independiente para gestionar Quire desde una terminal. Instálala una vez mediante npm o Homebrew, inicia sesión con OAuth y ejecuta subcomandos estructurados (quire project list, quire task create, quire mine) que puedes encadenar, incluir en scripts y programar con cron. Es una categoría distinta al servidor MCP de Quire, que es para agentes de IA como Claude Code o ChatGPT que llaman a Quire como herramientas. Elige la CLI cuando vives en una terminal y necesitas velocidad, capacidad de scripting y comandos predecibles.

La mayoría de los usuarios de Quire viven en el navegador. La aplicación web es la superficie adecuada para la planificación visual, las sublistas de arrastrar y soltar y las revisiones con partes interesadas. Pero existe un grupo más silencioso de usuarios (desarrolladores, operaciones, PMs técnicos, cualquiera que ya viva en una terminal) para quienes abrir una pestaña del navegador solo para marcar tres tareas como completadas se siente como trabajo extra. Quire CLI es para esas personas.

No es una herramienta de IA. No trae su propio modelo de lenguaje. Es el tipo de herramienta que son git, gh o aws: una interfaz de línea de comandos estructurada para un servicio que ya usas, donde cada acción corresponde a un comando predecible que puedes encadenar, incluir en scripts o programar. Inicia sesión una vez, y la próxima vez que necesites crear una tarea no interrumpirás tu flujo para buscar la pestaña correcta de Quire.

A continuación encontrarás la versión honesta de qué es Quire CLI, cómo instalarlo, los comandos que vale la pena conocer y los cinco flujos de trabajo de ejemplo que recuperan el tiempo de configuración en la primera semana.

¿Qué es Quire CLI?

Quire CLI (@quire-io/quire-cli en npm, quire una vez instalado) es un ejecutable único que se comunica con la API de Quire a través de OAuth.

Lo que es:

• Una herramienta de línea de comandos normal con subcomandos estructurados que puedes encadenar y usar en scripts.
• Respaldada por OAuth. Ejecuta quire login una vez, sin malabarismos con claves de API, sin configuraciones de cuentas de servicio.
• Multiplataforma. macOS, Linux, Windows, en cualquier lugar donde se ejecute Node.js o un binario único.
• Una interfaz directa con la API de Quire. Cada comando de la CLI corresponde a un endpoint real de la API, por lo que nada de lo que hace la CLI está oculto detrás de una superficie más delgada.

Lo que no es:

• Una herramienta de IA. Quire CLI no entiende el lenguaje natural. Los comandos son estructurados (quire task create "Marketing_Q4" --name "Draft launch email"), no prompts de Chat.
• Vinculada a ningún cliente de IA en particular. Si quieres que agentes de IA lean y escriban en Quire en tu nombre, ese es el trabajo del servidor MCP de Quire. Superficie diferente, audiencia diferente.

¿Por qué una CLI para Quire?

Tres razones concretas, no intuiciones.

Razón 1: Velocidad. Abrir Quire, encontrar el proyecto correcto, encontrar la tarea correcta y hacer clic en "completar" tarda entre 15 y 20 segundos incluso en un buen día. quire task complete <task-id> tarda un segundo desde una terminal que ya tienes abierta. Multiplica eso por las 30 interacciones diarias que hace un usuario intensivo de Quire, y la diferencia de tiempo se acumula.

Razón 2: Scripts y cron. Una CLI es un bloque de construcción para la automatización. Un script de shell matutino puede extraer tus tareas vencidas en un resumen de Markdown. Un objetivo make weekly-status puede buscar en cada proyecto los elementos completados esta semana y escribir una actualización de estado. Un trabajo cron puede publicar el resultado en Slack los viernes a las 4pm. Nada de eso es posible desde una ventana de Chat o una pestaña web.

Razón 3: Salida honesta. Cada comando de la CLI imprime lo que hizo. Ves el ID de la tarea que acaba de crear, la respuesta de la API, el error si algo falló. No hay llamadas a herramientas ocultas, ni "voy a crearlos por ti" sin forma de inspeccionar qué se registró. Cuando 40 tareas están a punto de entrar en un espacio de trabajo compartido, esa visibilidad marca la diferencia entre una herramienta útil y un riesgo.

Quire CLI vs servidor MCP de Quire vs API REST de Quire

Quire ofrece tres superficies programáticas. Usa la que mejor se adapte al trabajo.

El servidor MCP y la CLI se autentican mediante OAuth. La API REST usa tokens de acceso. Los tres operan sobre los mismos datos y respetan los mismos permisos, por lo que una tarea creada por cualquiera de ellos aparece inmediatamente en los demás.

Si quieres la parte de IA, la guía de configuración del MCP de Quire explica paso a paso cómo conectar el servidor MCP a Claude Code, ChatGPT o cualquier otro cliente compatible. La CLI y MCP son complementarios, no alternativas.

Requisitos previos

• Una cuenta de Quire gratuita o de pago con al menos una organización y proyecto que quieras controlar desde la terminal.
• Una terminal: macOS Terminal, iTerm2, Windows Terminal o cualquier shell de Linux.
• Uno de estos: Node.js 18 o superior (para la instalación por npm), Homebrew (macOS o Linux), o la posibilidad de descargar un binario de un solo archivo desde GitHub Releases.
• La capacidad de recibir una devolución de llamada OAuth en localhost. La mayoría de las redes lo permiten. Algunas VPNs corporativas lo bloquean. Si quire login se queda esperando el redireccionamiento, pide a TI que incluya en la lista blanca las redirecciones de loopback.

Instalación de Quire CLI

Quire CLI se distribuye como un único binario de línea de comandos. Elige el método de instalación que se adapte a cómo ya gestionas las CLIs. El README de GitHub lista todas las opciones.

npm (la mayoría de los usuarios):

npm i -g @quire-io/quire-cli

Homebrew (macOS o Linux):

brew install quire-io/quire/quire

Pruébalo sin instalar:

npx @quire-io/quire-cli --help

O descarga un binario de un solo archivo desde la página de GitHub Releases.

Una vez instalado, ejecuta el inicio de sesión OAuth por única vez. Se abre una pestaña del navegador, inicias sesión en Quire y apruebas el acceso al espacio de trabajo, y la CLI almacena su token en ~/.config/quire/credentials.json (o en el llavero del sistema operativo cuando está disponible):

quire login
quire whoami

Si quire whoami muestra tu cuenta, estás conectado. Prueba algunos comandos reales:

quire project list
quire task list "Marketing_Q4"
quire mine --all-orgs --json

Qué puede hacer Quire CLI

La superficie completa de subcomandos está documentada en el README de GitHub, pero los comandos que vale la pena conocer el primer día caben en una pantalla.

quire login                                       # configuración OAuth por única vez
quire whoami                                      # confirmar que has iniciado sesión
quire logout                                      # eliminar credenciales locales

quire project list                                # listar tus proyectos
quire task list "<project>"                       # listar tareas en un proyecto
quire task tree <task-id> --depth full            # vista de subárbol recursivo
quire task search "release notes" --mine          # buscar tareas (solo las tuyas)
quire task create "<project>" --name "Ship CLI v1" --due 2026-06-30
quire task complete <task-id>                     # marcar una tarea como completada
quire mine --all-orgs --json                      # listar tus tareas en todas las orgs

Cada comando admite --help para ver todas las opciones. La mayoría también admite --json para salida legible por máquina, que es la base de todos los flujos de trabajo de ejemplo siguientes.

Cada acción corresponde 1:1 a un endpoint de la API REST de Quire.

Flujos de trabajo de ejemplo

Cinco patrones pequeños que recuperan el tiempo de instalación en la primera semana.

Resumen para el standup diario

quire mine --all-orgs --json \
  | jq -r '.[] | select(.due == "2026-05-11") | "- [" + .name + "](" + .url + ") (" + .project + ")"'

Ejecútalo a las 9am y pega el markdown en Slack o en el documento de estado diario. Añade un alias a .zshrc para que sea una sola palabra a la mañana siguiente:

alias standup='quire mine --all-orgs --json | jq -r "..."'

Crear tareas en bloque a partir de notas de reunión

grep "^TODO:" ./meetings/2026-05-04-sync.md \
  | sed 's/^TODO: //' \
  | while read task; do
      quire task create "Marketing_Q4" \
        --name "$task" \
        --tag "from-monday-sync" \
        --due 2026-05-08
    done

Doce minutos de administración del lunes reducidos a un bucle de shell. Ponlo en un Makefile y el mismo objetivo funciona cada lunes sin que tengas que recordar la sintaxis.

Trabajo cron: resumen de tareas vencidas del viernes

0 17 * * 5  cd ~/work && /usr/local/bin/quire task search "overdue" --mine --json > friday.json

Combínalo con un script de seguimiento que publique el JSON en un webhook de Slack, genere una página de Notion o simplemente te lo envíe por correo. La CLI se encarga de la canalización de datos; lo que le conectes al final depende de ti.

Convertir un CSV de calendario de contenido en tareas

tail -n +2 ./calendar/2026-Q2.csv \
  | while IFS=, read -r publish_date channel title; do
      quire task create "Content_Pipeline" \
        --name "$title" \
        --due "$publish_date" \
        --tag "$channel"
    done

De CSV a tareas en una sola canalización. Idempotente si también etiquetas las filas con un identificador de origen para poder limpiar si una ejecución del script sale mal.

Completar tareas por ID desde un archivo

cat finished_today.txt | xargs -n 1 quire task complete

Donde finished_today.txt es simplemente una lista de IDs de tareas, uno por línea. Útil a las 5pm de un viernes cuando tienes ocho cosas que cerrar a la vez y hacer clic en cada una en el navegador se siente como un castigo.

Cuándo Quire CLI no es la opción adecuada

Algunas desventajas honestas.

• No usas una terminal. Si cd te resulta incómodo, la aplicación web de Quire es la superficie correcta. No hay nada que haga la CLI que la aplicación web no haga también; la CLI simplemente es más rápida para quienes ya viven en un shell.
• Quieres que la IA haga el razonamiento. Cuando el trabajo es "encuentra todos los proyectos paralizados y dime cuáles escalar", eso es trabajo de IA. Conecta el servidor MCP de Quire a Claude Code, Codex CLI, ChatGPT o Claude Desktop, y deja que el modelo decida qué herramientas llamar. La CLI gestiona la canalización de datos; MCP hace el razonamiento.
• Necesitas una integración del lado del servidor completamente gestionada. Para flujos de trabajo que se activan con webhooks o se ejecutan en un servicio que tú operas, la API REST de Quire es más duradera que una CLI respaldada por OAuth en el portátil de un desarrollador.
• Tu red bloquea las redirecciones de loopback de OAuth. Algunas VPNs corporativas lo hacen. Si quire login se queda esperando el redireccionamiento, pide a TI que incluya en la lista blanca las devoluciones de llamada de 127.0.0.1 antes de rendirte.

Consejos y buenas prácticas

• Usa --json y jq para todo lo que quieras reutilizar. La salida de texto plano es buena para leer; JSON es bueno para todo lo demás. La mayoría de los comandos de la CLI aceptan --json.
• Cita los nombres de proyecto exactamente. "Marketing_Q4" es inequívoco; "el de marketing" no es un nombre de proyecto que la CLI conozca. Los nombres de proyecto distinguen mayúsculas de minúsculas.
• Etiqueta las tareas creadas en bloque. Añadir --tag from-cli (o --tag bulk-import-2026-05-11) facilita encontrarlas y limpiarlas si una ejecución del script sale mal.
• Incluye el inicio de sesión OAuth en tu script de configuración para máquinas nuevas. Un quire login && quire whoami en una sola línea después de una instalación nueva deja un portátil nuevo en estado operativo en 30 segundos.
• Lee quire <command> --help. Es más corto y preciso que cualquier entrada de blog. Todas las opciones de cada subcomando están ahí.
• Combina la CLI con el servidor MCP. Usa la CLI para la mitad determinista (crear, completar, listar, buscar) y un cliente de IA conectado a MCP para la mitad ambigua (clasificar, resumir, planificar). Los mismos datos, dos superficies complementarias.

Conclusiones clave

El cambio interesante de 2026 no es que los clientes de IA puedan gestionar proyectos. Es que las personas que más gestión de proyectos hacen ya tenían una herramienta en la que confiaban: la terminal. Quire CLI les ofrece un punto de entrada de primera clase a su espacio de trabajo, sin IA en el camino a menos que la quieran.

Si vives en una terminal, instálala esta semana. Incorpora uno de los flujos de trabajo de ejemplo anteriores a tu rutina matutina o de los viernes. La configuración son cinco minutos. El retorno se acumula durante todo el tiempo que sigas usando Quire.

El servidor MCP sigue siendo la herramienta adecuada cuando el razonamiento es el trabajo. Los dos no son competidores; son superficies complementarias en el mismo espacio de trabajo.

Preguntas frecuentes

¿Qué es Quire CLI?

Quire CLI es una herramienta de línea de comandos independiente para Quire. Instálala mediante npm, Homebrew o un binario, ejecuta quire login y gestiona tareas, proyectos y documentos desde cualquier terminal.

¿Es Quire CLI lo mismo que el servidor MCP de Quire?

No. Quire CLI es para personas que escriben comandos. El servidor MCP de Quire es para agentes de IA que llaman a Quire como herramientas. Los mismos datos, audiencias distintas.

¿Necesito ser desarrollador para usar Quire CLI?

No. Si puedes abrir una terminal y ejecutar dos comandos, puedes usarla.

¿Qué puedo hacer con Quire CLI?

Listar y buscar tareas, crearlas en bloque, completarlas, organizar subtareas, gestionar proyectos y miembros, publicar comentarios, crear documentos. Todos los objetos de Quire son accesibles.

¿Cuándo debería usar el servidor MCP en su lugar?

Cuando el trabajo requiere razonamiento. Clasificación, resúmenes, conversión de notas sin estructura en tareas. Quire CLI es para la mitad determinista.

¿Funciona Quire CLI en trabajos cron?

Sí. Usa la salida --json, prográmala con cron y publica los resultados donde los necesites.

¿Hay un nivel gratuito?

Sí. El Free plan de Quire cubre el mismo acceso a la CLI que los planes de pago.

¿Listo para gestionar tu espacio de trabajo de Quire desde la terminal?

Instala Quire CLI desde npm, Homebrew o GitHub Releases. Cuenta Free de Quire, acceso completo, sin tarjeta de crédito.