Guia de instalação

O Catenary é distribuído como instalador de desktop comum para Windows, macOS e Linux. Esta página cobre o download, os avisos que o seu sistema operacional vai mostrar e por que eles existem.

Download

Os builds são publicados no GitHub Releases. O atualizador embutido consulta a mesma fonte, então depois de instalado você não baixa mais nada à mão.

No Windows, instale pelo Windows Package Manager:

winget install catenary

No macOS o caminho mais rápido é o Homebrew, com um comando só, que também evita o aviso do Gatekeeper descrito abaixo:

brew install --cask gionicolas/catenary/catenary

Ele adiciona o tap do Catenary, confia só neste cask (o Homebrew exige isso desde a versão 6), confere o checksum do download e instala o app em /Applications.

Windows: o aviso do SmartScreen

Na primeira execução, o Windows pode exibir o painel azul "O Windows protegeu o seu computador".

É o aviso padrão para um executável novo, sem reputação acumulada — não é a detecção de nada. Clique em Mais informações e depois em Executar assim mesmo.

Sem certificado de code signing, o SmartScreen conta a reputação por arquivo, e cada versão é um arquivo novo. Por isso o aviso pode voltar a cada versão, até o instalador ser assinado.

macOS: o Gatekeeper

Se você instalou pelo Homebrew, pule esta seção. Se baixou o .dmg, o macOS pode dizer que o app "não pode ser aberto porque o desenvolvedor não pode ser verificado", ou informar que o app "está danificado e deve ser movido para o Lixo".

macOS 15 Sequoia ou mais novo: tente abrir o Catenary uma vez e feche o aviso. Depois abra Ajustes do Sistema → Privacidade e Segurança, clique em Abrir Mesmo Assim ao lado da mensagem sobre o Catenary e confirme com a sua senha.

macOS 14 Sonoma ou anterior: clique com o botão direito (ou Control-clique) no Catenary dentro do Finder, escolha Abrir e confirme na caixa de diálogo.

Nos dois casos isso é feito uma única vez: o macOS lembra a decisão para aquela cópia.

Se o macOS ainda assim recusar abrir ou insistir que o arquivo está danificado, abra o Terminal do Mac e execute:

xattr -rd com.apple.quarantine /Applications/Catenary.app

(Se você não moveu o app para a pasta Aplicativos, substitua /Applications/Catenary.app pelo caminho onde o arquivo .app foi descompactado).

Por que os instaladores não são assinados

Com honestidade: um certificado de code signing para Windows custa cerca de US$ 200 por ano, e ele ainda não foi comprado. O plano é pagar o certificado com as vendas das licenças Pro. Até lá o instalador não é assinado — e é exatamente por isso que os dois avisos acima existem, e que esta página existe.

Primeira execução

Depois de uma tela de boas-vindas, o Catenary pergunta como você quer começar: TerminalMap, com splits guiados pelo teclado e um seletor de sessões, ou Canvas, o quadro espacial infinito. Nos dois casos você ganha um terminal na sua pasta Home, sem precisar de projeto. Dá para trocar de lente a qualquer momento, e nenhum processo reinicia.

Em seguida, um tour curto mostra o seletor de lentes, a barra lateral, os splits e as tarefas.

Quando você abre uma pasta de projeto, ela vira um workspace, e o estado dele é gravado em .cate/ dentro do próprio projeto.

Nenhuma conta, nenhuma chave e nenhuma conexão com a internet são necessárias para chegar até aqui.

Atualizações

As atualizações chegam pelo electron-updater a partir do GitHub Releases. Tudo da linha 1.x está incluído na licença Pro.