Download e Configuração

Instale via gerenciador de pacotes ou download direto do GitHub.

Caminhos de instalação oficiais para os principais sistemas operacionais.

Esta página segue o repositório oficial para garantir acesso às versões mais recentes em todas as plataformas.

01

Homebrew & Winget disponíveis

02

Downloads diretos

03

Notas por plataforma

Plataformas Suportadas

macOS / Windows / Linux

Suporte completo para macOS (Intel/Silicon), Windows x86_64 e Linux x86_64.

macOS

macOS + Homebrew

O caminho mais rápido e recomendado para usuários de macOS.

  • Método oficialmente recomendado no README.
  • O app fica pronto para uso imediatamente.
brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktop

Download Manual no macOS

  • Obtenha o `KatanA-Desktop-x.y.z.dmg` mais recente no GitHub Releases.
  • Arraste o `KatanA Desktop.app` para a pasta Aplicativos.
  • Caso encontre restrições do Gatekeeper no macOS Sequoia, você pode permitir em Preferências do Sistema > Segurança.
xattr -cr /Applications/KatanA\ Desktop.app

Windows x86_64

No Windows, o Winget é a opção mais veloz, com MSI disponível para download direto.

  • Instale via Winget ou baixe o `KatanA-windows-x86_64.msi`.
  • Execute o MSI para concluir a instalação.
  • Atalhos automáticos no Menu Iniciar e Área de Trabalho.
winget install HiroyukiFuruno.katana-desktop

Linux x86_64

Homebrew é recomendado para Linux, com opção de arquivo tar.gz.

  • Instale via Homebrew ou baixe o `KatanA-linux-x86_64.tar.gz`.
  • Extraia o arquivo e execute o binário diretamente.
brew tap HiroyukiFuruno/KatanA && brew install katana-desktop

Mantendo-se Atualizado

  • O KatanA possui um sistema inteligente de atualização integrado.
  • No macOS, use o botão "Update & Restart" dentro do app.
  • Windows e Linux recebem notificações que levam ao último lançamento.
  • Instalações via Homebrew no macOS migram automaticamente para o atualizador nativo após o primeiro update para evitar conflitos.

Configuração Opcional de Diagramas

Mermaid e ZenUML não exigem configuração extra; somente PlantUML pode exigir ferramenta adicional.

Mermaid

Sem setup extra

Diagramas Mermaid, incluindo diagramas de sequência ZenUML, renderizam no fluxo atual do documento.

PlantUML

Runtime Java

Instale o Java (`brew install openjdk@25`) e baixe o `plantuml.jar` quando solicitado pelo app.

Draw.io

Nativa

Renderização integrada, sem necessidade de configuração extra.

apos instalar

Apos instalar (3 verificacoes)

  • Abrir workspace: confirme README e specs na arvore.
  • Confirmar diagramas: abra Mermaid, incluindo ZenUML, ou PlantUML e valide renderizacao.
  • Verificar updates: execute a verificacao de update no app uma vez.

suporte

FAQ

PlantUML nao renderiza

Instale Java runtime e permita baixar plantuml.jar.

macOS bloqueia o app

Use Open Anyway em Privacy & Security ou execute xattr uma vez.

Support

Apoie o desenvolvimento do KatanA

Se este comando de instalação ajudou, considere dar Star ou apoiar o KatanA.

How to star on GitHub