Instalação

A única coisa a instalar é a ferramenta de linha de comando. Ela é publicada no npm como cfour-cli, e o comando que ela instala chama-se cfour.

Requisitos

• Node.js 20 ou mais novo, com o npm que vem junto.
• Git, se você quiser que a publicação carimbe automaticamente a branch e o commit. Sem Git a ferramenta funciona igual; você só informa a referência à mão.

Não há nada para instalar no servidor, nem banco de dados, nem Docker.

Instalar

npm install -g cfour-cli

Confira:

cfour version

Se preferir não instalar nada globalmente, rode sob demanda:

npx cfour-cli@latest version

Atualizar

npm install -g cfour-cli@latest

Vale atualizar quando você for publicar: a plataforma e a ferramenta conversam por uma interface versionada, e uma versão muito antiga pode ser recusada na publicação. A mensagem, quando isso acontece, diz o que fazer.

Autocompletar no terminal

A ferramenta emite o script de autocompletar do seu shell:

cfour completion bash   # ou: zsh, fish

Para instalar, redirecione a saída para onde o seu shell lê os completions. No bash, por exemplo:

cfour completion bash > ~/.local/share/bash-completion/completions/cfour

Onde a ferramenta guarda coisas

chaves de publicação	$XDG_CONFIG_HOME/cfour/credentials (ou ~/.config/cfour/credentials), com permissão 0600
tudo o mais	dentro do seu repositório, em arquivos que você versiona

Nenhum arquivo .env é lido automaticamente. As variáveis de ambiente que a ferramenta reconhece estão em Variáveis de ambiente.

Próximo passo

Com o cfour instalado, escreva o primeiro diagrama.