Apresentando o Quire CLI: Gerenciamento de projetos pelo seu terminal

Resumo
O Quire CLI é a ferramenta de linha de comando standalone para gerenciar o Quire a partir de um terminal. Instale uma vez via npm ou Homebrew, faça login com OAuth e execute subcomandos estruturados (quire project list, quire task create, quire mine) que você pode encadear, transformar em scripts e agendar com cron. É uma categoria diferente do servidor MCP do Quire, que é para agentes de IA como o Claude Code ou o ChatGPT que chamam o Quire como ferramentas. Use o CLI quando você vive no terminal e quer velocidade, possibilidade de scripts e comandos previsíveis.

A maioria dos usuários do Quire vive no navegador. O aplicativo web é a superfície certa para planejamento visual, sublistas com arrastar e soltar e revisões com stakeholders. Mas existe um grupo mais discreto de usuários — desenvolvedores, pessoas de operações, PMs técnicos, qualquer pessoa que já viva em um terminal — para quem abrir uma aba do navegador só para marcar três tarefas como concluídas parece desperdício. O Quire CLI é para essas pessoas.

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, onde cada ação corresponde a um comando previsível que você pode encadear, transformar em script ou agendar no cronograma. Faça login uma vez, e da próxima vez que precisar criar uma tarefa você não perde o foco procurando a aba certa do Quire.

A seguir, a versão direta do que é o Quire CLI, como instalá-lo, os comandos que valem a pena conhecer e os cinco fluxos de trabalho que recuperam o tempo de configuração já 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 se comunica com a API Quire via OAuth.

O que ele é:

• Uma ferramenta de linha de comando comum com subcomandos estruturados que você pode encadear e transformar em scripts.
• Autenticado por OAuth. Execute quire login uma vez — sem precisar gerenciar chaves de API nem configurar contas de serviço.
• Multiplataforma. macOS, Linux, Windows — qualquer lugar onde o 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, então nada que o CLI faz fica escondido atrás de uma camada mais fina.

O que ele não é:

• Uma ferramenta de IA. O Quire CLI não entende linguagem natural. Os comandos são estruturados (quire task create "Marketing_Q4" --name "Draft launch email"), não prompts de bate-papo.
• Vinculado a algum cliente de IA específico. Se você quiser que agentes de IA leiam e escrevam no Quire por você, esse é o trabalho do servidor MCP do Quire. Superfície diferente, público diferente.

Por que um CLI para o Quire?

Três razões concretas, sem achismos.

Razão 1: Velocidade. Abrir o Quire, encontrar o projeto certo, encontrar a tarefa certa e clicar em "concluir" leva de 15 a 20 segundos mesmo num dia tranquilo. quire task complete <task-id> leva um segundo em um terminal que você já tem aberto. Multiplique isso pelas 30 e tantas interações que um usuário assíduo do Quire faz por dia, e a diferença de hora se acumula.

Razão 2: Scripts e cron. Um CLI é um bloco de construção para automação. Um script de shell matinal pode puxar suas tarefas em atraso para um digest em Markdown. Um alvo make weekly-status pode pesquisar em todo projeto os itens concluídos na semana e escrever uma atualização de estado. Um cron job pode postar o resultado no Slack toda sexta às 16h. Nada disso é possível a partir de uma janela de bate-papo ou de uma aba do navegador.

Razão 3: Saída transparente. Todo comando do CLI exibe o que fez. Você vê o ID da tarefa que acabou de ser criada, a resposta da API, o erro se algo falhou. Não há chamadas de ferramentas ocultas, nem "vou criar essas para você" sem como verificar o que foi criado. Quando 40 tarefas estão prestes a entrar em um workspace compartilhado, essa visibilidade é a diferença entre uma ferramenta útil e um risco.

Quire CLI vs servidor MCP do Quire 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 ambos se autenticam via OAuth. A API REST usa tokens de acesso. Os três operam nos 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 de IA, o guia de configuração do MCP do Quire 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 alternativos.

Pré-requisitos

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

Instalando o Quire CLI

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

npm (para 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 de arquivo único na página do GitHub Releases.

Após a instalação, execute o login OAuth inicial. Uma aba do navegador abre, você faz login no Quire e aprova o acesso ao workspace, e o CLI armazena o token em ~/.config/quire/credentials.json (ou no keychain do sistema quando disponível):

quire login
quire whoami

Se quire whoami exibir 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

A superfície completa 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                                       # configuração OAuth inicial
quire whoami                                      # confirmar que você está autenticado
quire logout                                      # remover credenciais locais

quire project list                                # listar seus projetos
quire task list "<project>"                       # listar tarefas em um projeto
quire task tree <task-id> --depth full            # visão recursiva da subárvore
quire task search "release notes" --mine          # pesquisar tarefas (só 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 suas tarefas em todas as orgs

Cada comando aceita --help para 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.

Fluxos de trabalho de exemplo

Cinco padrões simples que recuperam o tempo de instalação já na primeira semana.

Digest para o daily standup

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 status diário. Adicione um alias ao .zshrc para que seja só uma palavra na manhã seguinte:

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 administração de segunda reduzidos a um loop de shell. Coloque em um Makefile e o mesmo alvo funciona toda segunda sem precisar lembrar a sintaxe.

Cron job: digest de tarefas em atraso às sextas

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

Combine com um script complementar que posta o JSON em um webhook do Slack, gera uma página no Notion ou simplesmente envia por e-mail. O CLI cuida do fluxo de dados; o que você conectar na saída é 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

CSV para tarefas em um único pipeline. Idempotente se você também marcar as linhas com um identificador de origem, facilitando a limpeza caso uma execução saia errada.

Concluir tarefas por ID a partir de um arquivo

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 sexta quando você tem oito coisas para fechar de uma vez e clicar em cada uma no navegador parece um castigo.

Quando o Quire CLI não é a escolha certa

Alguns tradeoffs honestos.

• Você não usa terminal. Se cd te deixa desconfortável, o aplicativo web do Quire é a superfície certa. Não há nada que o CLI faça que o aplicativo web não faça também; o CLI é simplesmente mais rápido para quem já vive no shell.
• Você quer que a IA faça o raciocínio. Quando o trabalho é "encontre todos os projetos parados e me diga quais escalar", isso é trabalho para IA. Conecte o servidor MCP do Quire ao Claude Code, Codex CLI, ChatGPT ou Claude Desktop e deixe o modelo decidir quais ferramentas chamar. O CLI faz o fluxo de dados; o MCP faz o raciocínio.
• Você precisa de uma integração server-side totalmente gerenciada. Para fluxos de trabalho que disparam em webhooks ou rodam em um serviço que você opera, a API REST do Quire é mais durável do que um CLI com OAuth rodando no laptop de um desenvolvedor.
• Sua rede bloqueia redirecionamentos OAuth de loopback. Algumas VPNs corporativas bloqueiam. Se quire login travar esperando pelo redirecionamento, peça ao TI para liberar callbacks em 127.0.0.1 antes de desistir.

Dicas e boas práticas

• Use --json e jq para tudo que quiser reutilizar. A saída em texto simples é boa para leitura; JSON é bom para todo o resto. A maioria dos comandos do CLI aceita --json.
• Cite os nomes de projetos exatamente. "Marketing_Q4" é inequívoco; "o de marketing" não é um nome de projeto que o CLI reconhece. Os nomes de projetos diferenciam maiúsculas de minúsculas.
• Aplique tags em tarefas criadas em massa. Adicionar --tag from-cli (ou --tag bulk-import-2026-05-11) facilita encontrar e limpar caso uma execução de script saia errada.
• Inclua o login OAuth no seu script de configuração para máquinas novas. Um quire login && quire whoami logo após uma instalação limpa deixa um laptop novo funcionando em 30 segundos.
• Leia quire <command> --help. É mais curto e mais preciso do que qualquer post de blog pode ser. Todas as opções de cada subcomando 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 conectado ao MCP para a metade ambígua (triagem, resumo, planejamento). Os mesmos dados, duas superfícies complementares.

Considerações finais

A mudança interessante de 2026 não é que clientes de IA possam gerenciar projetos. É que as pessoas que mais gerenciam projetos já tinham uma ferramenta em que confiavam: o terminal. O Quire CLI oferece a elas um ponto de entrada de primeira classe no workspace, sem nenhuma IA no caminho — a menos que queiram.

Se você vive em um terminal, instale esta semana. Incorpore um dos fluxos de trabalho de exemplo acima à sua rotina matinal ou de sexta-feira. A configuração leva cinco minutos. O retorno se acumula enquanto você continuar usando o Quire.

O servidor MCP ainda é a ferramenta certa quando o raciocínio é o trabalho. Os dois não são concorrentes; são superfícies complementares no mesmo workspace.

Perguntas frequentes

O que é o Quire CLI?

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

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

Não. O Quire CLI é para humanos digitando comandos. O servidor MCP do Quire é para agentes de IA que chamam o Quire como ferramentas. Os mesmos dados, públicos diferentes.

Preciso ser desenvolvedor para usar o Quire CLI?

Não. Se você consegue abrir um terminal e executar dois comandos, já dá para usar.

O que posso fazer com o Quire CLI?

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

Quando devo usar o servidor MCP em vez do CLI?

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

O Quire CLI funciona em cron jobs?

Sim. Use a saída --json, agende pelo cron e envie os resultados para 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 workspace do Quire pelo terminal?

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