Resumo
O ClickUpfy 1.0.0 foi refeito sobre o framework Termfy: um binário único em Bun reúne CLI, TUI e servidor MCP stdio. Os comandos e as ferramentas clickupfy_* da 0.9.0 continuam existindo, com mudanças no formato de saída e nos códigos de saída.
Novidades
- ClickUpfy 1.0.0 — Perfis e credenciais: as API keys ficam cifradas no cofre em
~/.clickupfy/credentials.json, com perfis em~/.clickupfy/accounts.jsone importação automática do~/clickupfy/config.jsonsem alterar o arquivo. - ClickUpfy 1.0.0 — Servidor MCP:
mcp servefixa o escopo, inclusive com--sprint-foldere--read-only.mcp --list-idemcp serve --describedescrevem as ferramentas, e os erros saem comisErrore o código de saída equivalente. - ClickUpfy 1.0.0 — TUI: a aba Overview mostra perfil, workspace, cronômetro em execução e perfis.
- ClickUpfy 1.0.0 — Documentação embutida:
clickupfy --skilltraz a documentação na máquina, eclickupfy --openclidescreve as ferramentas para o OpenCLI. - ClickUpfy 1.0.0 — Atualização:
upgradeatualiza pelo npm ou troca o binário pela GitHub Release.
Melhorias
- ClickUpfy 1.0.0 — Cronômetro: iniciar um cronômetro avisa quando outro está ativo numa tarefa diferente e devolve o anterior no campo
previous. - ClickUpfy 1.0.0 — Documentos:
doc page createedoc page updateleem o conteúdo de--file <path>ou do stdin com--file -. - ClickUpfy 1.0.0 — API: o comando
api call <operation>aceita--dry-rune--filerepetido. As ferramentas do catálogo deixam de exigir os identificadores fixados pelo servidor e o workspace do perfil. - ClickUpfy 1.0.0 — Diagnóstico:
doctorconfere perfil, API key, configuração antiga,.mcp.jsone.codex/config.toml. Com--online, valida a chave e as skills.
Breaking changes
- ClickUpfy 1.0.0 — Saída JSON:
--jsonusa o envelope{ ok, command, data }, e os erros saem como{ ok: false, command, error }. Scripts que liam o objeto cru precisam ler.data, e as listas vêm dentro de objetos, como{ tasks[] }e{ spaces[] }. - ClickUpfy 1.0.0 — Idioma e valores: mensagens, opções e campos do
--jsonficam em inglês. Os estados de item de checklist sãodoneepending, e os de Sprint sãoplanned,active,completederegular. - ClickUpfy 1.0.0 — Códigos de saída: a tabela acompanha o Termfy, com 2 para uso, 3 para configuração, 4 para credenciais, 5 para rede ou API, 6 para recurso inexistente, 7 para permissão e 130 para interrupção.
- ClickUpfy 1.0.0 — Filtros e pacote npm:
--statuse--assigneerecebem valores separados por vírgula, e o pacote@promovaweb/clickupfyvira um launcher que baixa o binário da plataforma na primeira execução, conferindo oSHA256SUMS.
Ponto de Atenção
A migração para a 1.0.0 exige revisar scripts que consomem --json e automatizações que leem os códigos de saída. A importação do config.json antigo não altera o arquivo, mas os perfis ficam no cofre.
Teste sugerido: rode clickupfy doctor numa máquina com a configuração antiga e confira o perfil importado. Depois, execute uma consulta com --json e valide o envelope { ok, command, data } no script consumidor. Repita uma chamada com código de uso inválido e confirme o código 2.
Notas da versão
O release oficial do ClickUpfy 1.0.0 foi publicado em 13/11/2026 pelo calendário UTC como versão estável.