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

Última atualização: 11 de maio de 2026

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. 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: qual devia usar?

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

O servidor MCP e o CLI autenticam-se ambos 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.

Quer saber como o Quire se compara a outras ferramentas em suporte MCP? Consulte Project Management Tools That Speak MCP: The 2026 Landscape para a comparação completa.

O que precisa antes de instalar o Quire CLI?

• 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. ## Como instala 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.

Alguns exemplos de fluxos de trabalho do Quire CLI

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 é que 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.

  Algumas dicas e boas práticas para o Quire CLI

• 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.