Apresentando o Quire CLI: Gestão de projetos a partir do seu terminal

Resumo
O Quire CLI é a ferramenta de linha de comandos autónoma para gerir o Quire a partir de um terminal. Instale uma vez via npm ou Homebrew, inicie sessão com OAuth, e execute subcomandos estruturados (quire project list, quire task create, quire mine) que pode encadear, incluir em scripts e agendar com cron. É uma categoria diferente do servidor Quire MCP, que se destina a agentes de IA como o Claude Code ou o ChatGPT que chamam o Quire como ferramentas. Escolha o CLI quando vive num terminal e quer velocidade, capacidade de scripting e comandos previsíveis.

A maioria dos utilizadores do Quire vive no browser. A aplicação web é a superfície certa para planeamento visual, sub-listas com arrastar e largar, e revisões com partes interessadas. Mas existe um grupo mais discreto de utilizadores — programadores, operações, PMs técnicos, qualquer pessoa que já viva num terminal — para quem abrir um separador do browser apenas para marcar três tarefas como concluídas parece trabalho desnecessário. O Quire CLI é para essas pessoas.

Não é uma ferramenta de IA. Não traz consigo um modelo de linguagem próprio. É o tipo de ferramenta que git, gh ou aws são: uma interface de linha de comandos estruturada para um serviço que já utiliza, onde cada ação corresponde a um comando previsível que pode encadear, incluir em scripts ou agendar no Cronograma. Inicie sessão uma vez, e da próxima vez que precisar de criar uma tarefa não vai ter de interromper o fluxo de trabalho para encontrar o separador certo do Quire.

Segue-se a versão honesta do que é o Quire CLI, como instalá-lo, os comandos que vale a pena conhecer, e os cinco exemplos de fluxos de trabalho que compensam o tempo de configuração logo na primeira semana.

O que é o Quire CLI?

O Quire CLI (@quire-io/quire-cli no npm, quire após a instalação) é um executável único que comunica com a API Quire via OAuth.

O que é:

• Uma ferramenta de linha de comandos normal com subcomandos estruturados que pode encadear e incluir em scripts.
• Autenticado por OAuth. Execute quire login uma vez, sem gestão de chaves de API nem configurações de contas de serviço.
• Multiplataforma. macOS, Linux, Windows — em qualquer lugar onde Node.js ou um binário único funcione.
• Uma interface direta com a API Quire. Cada comando do CLI corresponde a um endpoint real da API, pelo que nada do que o CLI faz está escondido por detrás de uma superfície mais limitada.

O que não é:

• Uma ferramenta de IA. O Quire CLI não compreende linguagem natural. Os comandos são estruturados (quire task create "Marketing_Q4" --name "Draft launch email"), não são prompts de Chat.
• Associado a qualquer cliente de IA específico. Se quiser que agentes de IA leiam e escrevam no Quire em seu nome, esse é o papel do servidor Quire MCP. Superfície diferente, público diferente.

Porquê um CLI para o Quire?

Três razões concretas, sem rodeios.

Razão 1: Velocidade. Abrir o Quire, encontrar o projeto certo, encontrar a tarefa certa, clicar em "concluir" demora entre 15 a 20 segundos mesmo num bom dia. quire task complete <task-id> demora um segundo num terminal que já tem aberto. Multiplique isso pelas 30 e tal interações diárias de um utilizador assíduo do Quire, e a diferença de tempo acumula-se rapidamente.

Razão 2: Scripts e cron. Um CLI é um bloco de construção para automação. Um script de shell matinal pode recolher as suas tarefas em atraso e transformá-las num digest em Markdown. Um target make weekly-status pode pesquisar todos os projetos em busca de itens concluídos esta semana e redigir uma atualização de estado. Uma tarefa cron pode publicar o resultado no Slack às sextas-feiras às 16h. Nada disso é possível a partir de uma janela de Chat ou de um separador web.

Razão 3: Saída transparente. Cada comando do CLI imprime o que fez. Vê o ID da tarefa que acabou de criar, a resposta da API, o erro caso algo tenha falhado. Não há chamadas de ferramentas ocultas, nem "vou criar esses itens para si" sem forma de verificar o que foi criado. Quando 40 tarefas estão prestes a entrar num espaço de trabalho partilhado, essa visibilidade é a diferença entre uma ferramenta útil e um risco.

Quire CLI vs servidor Quire MCP vs API REST do Quire

O Quire oferece três superfícies programáticas. Use a que corresponde ao trabalho.

O servidor MCP e o CLI autenticam-se via OAuth. A API REST utiliza tokens de acesso. Os três operam sobre os mesmos dados e respeitam as mesmas permissões, pelo que uma tarefa criada por qualquer um deles aparece imediatamente nos restantes.

Se pretende o lado de IA, o guia de configuração do Quire MCP explica passo a passo como ligar o servidor MCP ao Claude Code, ChatGPT ou qualquer outro cliente compatível. O CLI e o MCP são complementares, não alternativos.

Pré-requisitos

• Uma conta Quire gratuita ou paga com pelo menos uma organização e um projeto que pretende controlar a partir do terminal.
• Um terminal: macOS Terminal, iTerm2, Windows Terminal, ou qualquer shell Linux.
• Um dos seguintes: Node.js 18 ou superior (para a instalação via npm), Homebrew (macOS ou Linux), ou a capacidade de descarregar um binário de ficheiro único a partir do GitHub Releases.
• A capacidade de receber um callback OAuth em localhost. A maioria das redes permite isso. Algumas VPNs corporativas bloqueiam-no. Se quire login ficar à espera do redirecionamento sem resposta, peça ao departamento de TI para autorizar redirecionamentos de loopback.

Instalar o Quire CLI

O Quire CLI é distribuído como um único binário de linha de comandos. Escolha o método de instalação que melhor se adequa à forma como já gere CLIs. O README do GitHub lista todas as opções.

npm (para a maioria dos utilizadores):

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

Homebrew (macOS ou Linux):

brew install quire-io/quire/quire

Experimentar sem instalar:

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

Ou descarregue um binário de ficheiro único a partir da página GitHub Releases.

Após a instalação, execute o login OAuth único. Abre-se um separador do browser, inicia sessão no Quire e aprova o acesso ao espaço de trabalho, e o CLI guarda o seu token em ~/.config/quire/credentials.json (ou no porta-chaves do sistema operativo, quando disponível):

quire login
quire whoami

Se quire whoami apresentar a sua conta, está ligado. Experimente alguns comandos reais:

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

O que o Quire CLI consegue fazer

A superfície completa de subcomandos está documentada no README do GitHub, mas os comandos que vale a pena conhecer no primeiro dia cabem num único ecrã.

quire login                                       # configuração OAuth única
quire whoami                                      # confirmar que está autenticado
quire logout                                      # remover credenciais locais

quire project list                                # listar os seus projetos
quire task list "<project>"                       # listar tarefas num projeto
quire task tree <task-id> --depth full            # vista recursiva da subárvore
quire task search "release notes" --mine          # pesquisar tarefas (apenas as suas)
quire task create "<project>" --name "Ship CLI v1" --due 2026-06-30
quire task complete <task-id>                     # marcar uma tarefa como concluída
quire mine --all-orgs --json                      # listar as suas tarefas em todas as orgs

Todos os comandos suportam --help para opções completas. A maioria também suporta --json para saída legível por máquina, que é a base de todos os exemplos de fluxos de trabalho abaixo.

Cada ação corresponde 1:1 a um endpoint da API REST do Quire.

Exemplos de fluxos de trabalho

Cinco padrões simples que compensam o tempo de instalação logo na primeira semana.

Digest para o standup diário

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

Execute às 9h, cole o markdown no Slack ou no documento de estado diário. Adicione um alias ao .zshrc para que seja uma palavra na manhã seguinte:

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

Criação em massa de tarefas a partir de notas de reunião

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

Doze minutos de administração de segunda-feira reduzidos a um ciclo de shell. Coloque-o num Makefile e o mesmo target funciona todas as segundas-feiras sem precisar de se lembrar da sintaxe.

Tarefa cron: digest de tarefas em atraso às sextas-feiras

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

Combine com um script subsequente que publique o JSON num webhook do Slack, gere uma página do Notion, ou simplesmente o envie por email. O CLI trata da gestão dos dados; o que ligar à saída fica ao seu critério.

Converter um CSV de calendário de conteúdos em tarefas

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 tarefas numa única pipeline. Idempotente se também etiquetar as linhas com um identificador de origem, para facilitar a limpeza caso uma execução do script corra mal.

Concluir tarefas por ID a partir de um ficheiro

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

Onde finished_today.txt é apenas uma lista de IDs de tarefas, um por linha. Útil às 17h de uma sexta-feira quando tem oito coisas para fechar de uma vez e clicar em cada uma no browser parece um castigo.

Quando o Quire CLI não é a solução certa

Algumas trocas a considerar honestamente.

• Não usa um terminal. Se cd o deixa desconfortável, a aplicação web do Quire é a superfície certa. Não há nada que o CLI faça que a aplicação web não faça também; o CLI é apenas mais rápido para quem já vive numa shell.
• Quer que a IA faça o raciocínio. Quando o trabalho é "encontra todos os projetos parados e diz-me quais escalar," isso é trabalho para IA. Ligue o servidor Quire MCP ao Claude Code, Codex CLI, ChatGPT ou Claude Desktop, e deixe o modelo decidir quais as ferramentas a chamar. O CLI faz a gestão dos dados; o MCP faz o raciocínio.
• Precisa de uma integração totalmente gerida do lado do servidor. Para fluxos de trabalho que se ativam via webhooks ou que correm num serviço que opera, a API REST do Quire é mais robusta do que um CLI autenticado por OAuth instalado no portátil de um programador.
• A sua rede bloqueia redirecionamentos OAuth de loopback. Algumas VPNs corporativas fazem-no. Se quire login ficar parado à espera do redirecionamento, peça ao departamento de TI para autorizar callbacks em 127.0.0.1 antes de desistir.

Dicas e boas práticas

• Use --json e jq para tudo o que queira reutilizar. A saída em texto simples é boa para leitura; o JSON é bom para todo o resto. A maioria dos comandos do CLI aceita --json.
• Coloque os nomes dos projetos entre aspas com exatidão. "Marketing_Q4" é inequívoco, "o de marketing" não é um nome de projeto que o CLI reconheça. Os nomes de projetos são sensíveis a maiúsculas e minúsculas.
• Etiquete as tarefas criadas em massa. Adicionar --tag from-cli (ou --tag bulk-import-2026-05-11) torna trivial encontrá-las e limpá-las caso uma execução de script corra mal.
• Inclua o login OAuth no seu script de configuração para novas máquinas. Um quire login && quire whoami numa linha após uma instalação nova coloca um portátil novo em estado funcional em 30 segundos.
• Leia quire <command> --help. É mais curto e preciso do que qualquer publicação de blog consegue ser. Todas as opções de todos os subcomandos estão lá.
• Combine o CLI com o servidor MCP. Use o CLI para a metade determinística (criar, concluir, listar, pesquisar) e um cliente de IA ligado ao MCP para a metade ambígua (triagem, resumos, planeamento). Os mesmos dados, duas superfícies complementares.

Principais conclusões

A mudança interessante em 2026 não é que os clientes de IA consigam gerir projetos. É que as pessoas que mais gerem projetos já tinham uma ferramenta em que confiavam: o terminal. O Quire CLI dá-lhes um ponto de entrada de primeira classe para o seu espaço de trabalho, sem IA no caminho a não ser que a queiram.

Se vive num terminal, instale-o esta semana. Integre um dos exemplos de fluxos de trabalho acima na sua rotina matinal ou de sexta-feira. A configuração demora cinco minutos. O retorno acumula-se enquanto continuar a usar o Quire.

O servidor MCP continua a ser a ferramenta certa quando o raciocínio é o trabalho. Os dois não são concorrentes; são superfícies complementares no mesmo espaço de trabalho.

Perguntas frequentes

O que é o Quire CLI?

O Quire CLI é uma ferramenta de linha de comandos autónoma para o Quire. Instale via npm, Homebrew ou um binário, execute quire login, e gira tarefas, projetos e documentos a partir de qualquer terminal.

O Quire CLI é o mesmo que o servidor Quire MCP?

Não. O Quire CLI destina-se a humanos que escrevem comandos. O servidor Quire MCP destina-se a agentes de IA que chamam o Quire como ferramentas. Os mesmos dados, públicos diferentes.

Preciso de ser programador para usar o Quire CLI?

Não. Se conseguir abrir um terminal e executar dois comandos, já consegue usá-lo.

O que posso fazer com o Quire CLI?

Listar e pesquisar tarefas, criá-las em massa, concluí-las, organizar sub-tarefas, gerir projetos e membros, publicar comentários, criar documentos. Todos os objetos do Quire são acessíveis.

Quando devo usar o servidor MCP em vez do CLI?

Quando o trabalho requer raciocínio. Triagem, resumos, transformar notas não estruturadas em tarefas. O Quire CLI serve para a metade determinística.

O Quire CLI funciona em tarefas cron?

Sim. Use a saída --json, agende com cron, publique os resultados onde precisar.

Existe um nível gratuito?

Sim. O Free plan do Quire oferece o mesmo acesso ao CLI que os planos pagos.

Pronto para gerir o seu espaço de trabalho Quire a partir do terminal?

Instale o Quire CLI via npm, Homebrew ou GitHub Releases. Conta Quire gratuita, acesso completo, sem cartão de crédito.