Apresentando o Quire CLI: Gerenciamento de projetos pelo seu terminal

Última atualização: 30 de setembro de 2026

A maioria dos usuários do Quire vive no navegador. O app web é a superfície certa para planejamento visual, sublistas com arrastar e soltar e revisões com stakeholders. Mas existe um grupo mais discreto (devs, ops, PMs técnicos, qualquer pessoa que já mora no terminal) para quem abrir uma aba do navegador só para concluir três tarefas parece trabalho demais. O Quire CLI é para essas pessoas.

Ele não é uma ferramenta de IA. Não traz um modelo de linguagem próprio. É o tipo de ferramenta que git, gh ou aws são: uma interface de linha de comando estruturada para um serviço que você já usa, em que cada ação corresponde a um comando previsível que você pode encadear, automatizar ou agendar.

Faça login uma vez e, da próxima vez que precisar criar uma tarefa, você não perde o ritmo procurando a aba certa do Quire.

A seguir, a versão sem enrolação do que é o Quire CLI, como instalá-lo, os comandos que valem a pena conhecer e os cinco fluxos de exemplo que compensam o tempo de configuração já na primeira semana.

O que é o Quire CLI?

O Quire CLI (@quire-io/quire-cli no npm, quire depois de instalado) é um único executável que conversa com a API Quire via OAuth.

O que ele é:

• Uma ferramenta de linha de comando comum, com subcomandos estruturados que você pode encadear e automatizar.
• Baseada em OAuth. Execute quire login uma vez, sem malabarismo com chaves de API, sem complicação de conta de serviço.
• Multiplataforma. macOS, Linux, Windows, em qualquer lugar onde rode Node.js ou um binário único.
• Uma interface direta para a API Quire. Cada comando do CLI corresponde a um endpoint real da API, então nada do que o CLI faz fica escondido atrás de uma superfície mais limitada.

Como ele se encaixa ao lado do Quire MCP:

• Estruturado por design. Os comandos são estruturados (quire task create "Marketing_Q4" --name "Draft launch email"), então scripts e pipes obtêm o mesmo resultado a cada execução.
• Feito para quem está no terminal. Quando você quer que agentes de IA leiam e escrevam no Quire em seu nome, o servidor Quire MCP foi feito para isso. Superfície diferente, público diferente.

Por que usar um CLI para o Quire?

Três motivos concretos, sem papo vazio.

Motivo 1: Velocidade. Abrir o Quire, achar o projeto certo, achar a tarefa certa e clicar em "concluir" leva de 15 a 20 segundos, mesmo num dia bom. quire task complete <task-id> leva um segundo em um terminal que você já deixou aberto. Multiplique isso pelas 30 e poucas interações diárias de quem usa muito o Quire, e a diferença de tempo se acumula.

Motivo 2: Scripts e cron. Um CLI é um bloco de construção para automação. Um script de shell matinal pode reunir suas tarefas em atraso em um resumo em Markdown. Um alvo make weekly-status pode buscar em todos os projetos os itens concluídos na semana e escrever uma atualização de estado.

Um job do cron pode postar o resultado no Slack às sextas, às 16h. Nada disso é possível a partir de uma janela de bate-papo ou de uma aba da web.

Motivo 3: Saída transparente. Todo comando do CLI imprime o que fez. Você vê o ID da tarefa que acabou de criar, a resposta da API e o erro, se algo falhou.

Não há chamadas de ferramenta ocultas, nem um "vou criar isso para você" sem nenhum jeito de inspecionar o que foi parar lá. Quando 40 tarefas estão prestes a entrar em um espaço de trabalho compartilhado, essa visibilidade é a diferença entre uma ferramenta útil e um risco.

Quire CLI, servidor Quire MCP ou API REST do Quire: qual usar?

O Quire oferece três superfícies programáticas. Use a que combina com o trabalho.

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

Se você quer o lado da IA, o guia de configuração do Quire MCP mostra como conectar o servidor MCP ao Claude Code, ao ChatGPT ou a qualquer outro cliente compatível. O CLI e o MCP são complementares, não alternativas.

Quer saber como o Quire se compara a outras ferramentas em suporte a MCP? Veja Project Management Tools With MCP Support in 2026 para a comparação completa.

O que você precisa antes de instalar o Quire CLI?

• Uma conta Quire gratuita ou paga, com pelo menos uma organização e um projeto que você queira controlar pelo terminal.
• Um terminal: o Terminal do macOS, iTerm2, Windows Terminal ou qualquer shell Linux.
• Uma destas opções: Node.js 18 ou mais recente (para a instalação via npm), Homebrew (macOS ou Linux) ou a possibilidade de baixar um binário único do GitHub Releases.
• A capacidade de receber um callback OAuth em localhost. A maioria das redes permite isso. Algumas VPNs corporativas bloqueiam. Se o quire login expirar esperando o redirecionamento, peça à TI para liberar redirecionamentos de loopback.

Como instalar o Quire CLI?

O Quire CLI é distribuído como um único binário de linha de comando. Escolha o método de instalação que combina com a forma como você já gerencia seus CLIs. O README no GitHub lista todas as opções.

npm (a maioria dos usuários):

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

Homebrew (macOS ou Linux):

brew install quire-io/quire/quire

Experimente sem instalar:

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

Ou baixe um binário único na página do GitHub Releases.

Depois de instalado, faça o login OAuth único. Uma aba do navegador se abre, você entra no Quire e aprova o acesso ao espaço de trabalho, e o CLI guarda o token em ~/.config/quire/credentials.json (ou no chaveiro do sistema, quando disponível):

quire login
quire whoami

Se o quire whoami mostrar a sua conta, você está conectado. Experimente alguns comandos reais:

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

O que o Quire CLI pode fazer?

Toda a superfície de subcomandos está documentada no README do GitHub, mas os comandos que valem a pena conhecer no primeiro dia cabem em uma tela.

quire login                                       # one-time OAuth setup
quire whoami                                      # confirm you are signed in
quire logout                                      # remove local credentials

quire project list                                # list your projects
quire task list "<project>"                       # list tasks in a project
quire task tree <task-id> --depth full            # recursive subtree view
quire task search "release notes" --mine          # search tasks (yours only)
quire task create "<project>" --name "Ship CLI v1" --due 2026-06-30
quire task complete <task-id>                     # mark a task done
quire mine --all-orgs --json                      # list your tasks across orgs

Todo comando aceita --help para ver as opções completas. A maioria também aceita --json para saída legível por máquina, que é a base de todos os fluxos de exemplo abaixo.

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

Quais são alguns fluxos de exemplo com o Quire CLI?

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

Resumo diário da daily

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

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

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

Criar tarefas em massa 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 burocracia de segunda-feira reduzidos a um loop de shell. Coloque num Makefile e o mesmo alvo funciona toda segunda sem você precisar lembrar a sintaxe.

Job do cron: resumo de tarefas em atraso das sextas

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

Combine com um script de acompanhamento que poste o JSON em um webhook do Slack, gere uma página no Notion ou simplesmente envie por e-mail para você. O CLI cuida do encanamento dos dados; o que você acoplar no final fica por sua conta.

Converter um CSV de calendário de conteúdo 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

Do CSV às tarefas em um único pipeline. É idempotente se você também marcar as linhas com um identificador de origem, para poder limpar tudo caso uma execução dê errado.

Concluir tarefas por ID a partir de um arquivo

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

Em que finished_today.txt é apenas uma lista de IDs de tarefas, um por linha. Útil às 17h de uma sexta, quando você tem oito coisas para fechar de uma vez e clicar em cada uma no navegador parece castigo.

Qual superfície do Quire serve para cada trabalho?

O CLI é uma de quatro formas de entrar no Quire, e cada uma das outras três tem a sua função:

• O app web, se você não vive no terminal. Tudo o que o CLI faz, o app web também faz; o CLI é simplesmente mais rápido para quem já trabalha no shell.
• Quire MCP, quando você quer que a IA faça o raciocínio. Quando o trabalho é "encontre todos os projetos parados e diga quais escalar", isso é trabalho de IA. Conecte o servidor Quire MCP ao Claude Code, ao Codex CLI, ao ChatGPT ou ao Claude Desktop e deixe o modelo decidir quais ferramentas chamar. O CLI cuida do encanamento de dados; o MCP cuida do raciocínio.
• A API REST, para integrações no servidor. Para fluxos que disparam por webhooks ou rodam em um serviço que você opera, a API REST do Quire foi feita para rodar sem supervisão.

Uma observação de configuração: algumas VPNs corporativas bloqueiam redirecionamentos de loopback do OAuth. Se o quire login ficar esperando o redirecionamento, peça à TI para permitir callbacks de 127.0.0.1.

Quais são algumas dicas e boas práticas para o Quire CLI?

• Use --json e jq para tudo o que você quiser reaproveitar. A saída em texto simples é boa para ler; o JSON é bom para todo o resto. A maioria dos comandos do CLI aceita --json.
• Escreva os nomes dos projetos exatamente como são. "Marketing_Q4" é inequívoco; "aquele de marketing" não é um nome de projeto que o CLI conheça. Os nomes de projeto diferenciam maiúsculas de minúsculas.
• Marque com uma tag as tarefas criadas em massa. Adicionar --tag from-cli (ou --tag bulk-import-2026-05-11) facilita encontrar e limpar tudo caso uma execução de script dê errado.
• Coloque o login OAuth no seu script de configuração de máquinas novas. Um quire login && quire whoami logo após uma instalação limpa leva um notebook novo a um estado funcional em 30 segundos.
• Leia quire <command> --help. É mais curto e mais preciso do que qualquer post 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, buscar) e um cliente de IA conectado ao MCP para a metade ambígua (triagem, resumo, planejamento). Mesmos dados, duas superfícies complementares.

Principais conclusões

A mudança interessante de 2026 não é que clientes de IA consigam gerenciar projetos. É que as pessoas que mais fazem gestão de projetos já tinham uma ferramenta em que confiavam: o terminal. O Quire CLI oferece a elas uma porta de entrada de primeira classe para o espaço de trabalho, sem nenhuma IA no caminho, a menos que queiram uma.

Se você vive no terminal, instale esta semana. Encaixe um dos fluxos de exemplo acima na sua rotina da manhã ou da sexta. A configuração leva cinco minutos. O retorno se acumula enquanto você continuar usando o Quire.

O servidor MCP continua sendo a ferramenta certa quando o trabalho é raciocinar. Os dois não são concorrentes; são superfícies complementares sobre o mesmo espaço de trabalho.

Perguntas frequentes

O que é o Quire CLI?

O Quire CLI é uma ferramenta de linha de comando independente para o Quire. Instale via npm, Homebrew ou binário, execute quire login e gerencie tarefas, projetos e documentos de qualquer terminal.

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

Não. O Quire CLI é para pessoas digitando comandos. O servidor Quire MCP é para agentes de IA que chamam o Quire como ferramentas. Mesmos dados, público diferente.

Preciso ser desenvolvedor para usar o Quire CLI?

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

O que posso fazer com o Quire CLI?

Listar e buscar tarefas, criá-las em massa, concluí-las, organizar subtarefas, gerenciar projetos e membros, postar comentários, criar documentos. Todo objeto do Quire está ao alcance.

Quando devo usar o servidor MCP em vez dele?

Quando o trabalho exige raciocínio. Triagem, resumos, transformar notas desestruturadas em tarefas. O Quire CLI é para a metade determinística.

O Quire CLI funciona em jobs do cron?

Sim. Use a saída --json, agende pelo cron e poste os resultados onde precisar.

Existe um plano gratuito?

Sim. O plano gratuito do Quire oferece o mesmo acesso ao CLI que os planos pagos.

Pronto para gerenciar seu espaço de trabalho do Quire pelo terminal?

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