O que é o just?
O just é um prático executor de comandos escrito em Rust por Casey Rodarmor. Ele salva e executa comandos específicos de projetos, chamados receitas, armazenados em um arquivo chamado justfile com uma sintaxe inspirada no make. Ao contrário do make, o just não é um sistema de compilação: as receitas são simplesmente comandos a executar, então não há alvos fictícios nem dependência dos horários de modificação dos arquivos. Com mais de 25 mil estrelas no GitHub, ele se tornou o executor de tarefas preferido para projetos modernos.
.PHONY por toda parte? Farto de erros de tabulação versus espaço e regras de compilação implícitas que disparam quando você menos espera? O just mantém a familiaridade das receitas de um Makefile, mas descarta a bagagem de sistema de compilação — toda receita é apenas um comando.
⚡ Principais Recursos do just
📝 Sintaxe Inspirada no Make
Escreva receitas em um justfile familiar e legível. Se você conhece Makefiles, já conhece a maior parte do just — sem as esquisitices.
🧩 Parâmetros de Receita
As receitas aceitam argumentos e têm valores padrão, então uma única receita pode se adaptar a muitas invocações sem scripts extras.
🐚 Qualquer Shell ou Linguagem
Escreva receitas em sh, bash, Python, Node ou qualquer outra coisa com uma linha shebang. O just executa cada receita com o interpretador que você escolher.
📋 Listar e Descobrir
Execute just --list para ver todas as receitas com seus comentários de documentação. Novatos podem explorar as tarefas de um projeto instantaneamente.
🔐 .env e Variáveis
Carregue arquivos de ambiente, defina variáveis e interpole-as nas receitas. Mantenha a configuração organizada e fora dos seus comandos.
🌍 Multiplataforma
Um único binário estático que funciona da mesma forma no Linux, macOS e Windows — sem runtime, sem interpretador, sem esquisitices.
🏆 Benefícios de Produtividade
- Economize Tempo: Execute qualquer tarefa do projeto com
just <receita>em vez de lembrar comandos longos - Autodocumentado:
just --listmostra cada tarefa e sua descrição - Consistente: Toda a equipe executa os mesmos comandos da mesma forma
- Sem Esquisitices de Build: Receitas são comandos, não alvos — sem surpresas de timestamps desatualizados
- Portátil: Um único justfile funciona no Linux, macOS e Windows
apt upgrade mantém você sempre na versão mais recente.
📦 Instalação a partir do deb.griffo.io
Passo 1: Adicionar repositório
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Existe um espelho grátis para sempre. deb-free.griffo.io distribui pacotes grátis para sempre — sem conta, sem assinatura, no máximo 2 meses atrás do upstream, correções de segurança imediatas. Hoje ele traz cliamp, Ghostty, lazydocker, Oh My Posh e Zed; just não está entre elas, então o repositório acima é a única forma de instalar hoje — peça e ela pode ser adicionada.
🧩 Sobre a opção extrepo. extrepo é a ferramenta do próprio Debian para repositórios externos: ela escreve o arquivo de sources e instala a chave de assinatura para você, conferindo a chave contra metadados assinados antes de usá-la. Este repositório está registrado nela como griffo, e o espelho gratuito para sempre como griffo-free, então no Debian (bookworm, trixie, forky e sid) os comandos acima são toda a configuração.
O extrepo configura apenas o arquivo de sources e a chave: as credenciais de uma assinatura continuam indo em /etc/apt/auth.conf.d/deb.griffo.io.conf. O Ubuntu não é coberto, porque o extrepo publica metadados só para as suítes do Debian: lá, use os comandos com sudo ou como root.
Passo 2: Instalar o just
# Instalar o último just
sudo apt install just
# Verificar instalação
just --version# Instalar o último just
apt install just
# Verificar instalação
just --versionPasso 3: Criar seu primeiro justfile
# Create a justfile in your project
cat > justfile <<'EOF'
# Build the project
build:
cargo build --release
# Run the tests
test:
cargo test
# Say hello to someone
hello name='world':
echo "Hello, {{name}}!"
EOF
# List available recipes
just --list
# Run a recipe
just build
just hello just🎯 Exemplos de uso básico
Executando receitas:
# Run the first recipe in the justfile (the default)
just
# Run a specific recipe
just test
# Pass an argument to a recipe
just hello Dario
# List every recipe with its documentation
just --listTrabalhando com justfiles:
# Show the resolved value of a variable
just --evaluate
# Print a recipe without running it
just --show build
# Use a justfile in another directory
just --justfile ~/project/justfile --working-directory ~/project build
# Choose a recipe interactively (needs a chooser like fzf)
just --chooseAutocompletar de shell:
# Completions for bash, fish and zsh are installed with the package.
# Generate them manually for any shell if you need to:
just --completions bash
just --completions zsh
just --completions fish🚀 Por que escolher o deb.griffo.io?
- Debian Oficial: Disponível, mas frequentemente versões desatualizadas
- Cargo Install: Requer toolchain Rust e compilação
- Script de Instalação: Atualizações manuais e sem gerenciamento de pacotes
- deb.griffo.io: Última versão com atualizações automáticas
- ✅ Últimos Recursos: Obtenha os mais novos atributos e funções de receita
- ✅ Sem Compilação Rust: Binários pré-compilados, sem necessidade de toolchain
- ✅ Atualizações Automáticas: Pacotes atualizados em horas após os lançamentos upstream
- ✅ Pacote Completo: Inclui autocompletar de shell e a página de manual
- ✅ Multi-Distribuição: Funciona no Bookworm, Trixie e Sid
- ✅ Manutenção Fácil: Comandos apt padrão para atualizações
📦 Repositório de construção de pacotes
Os pacotes do Debian são construídos e mantidos automaticamente neste repositório do GitHub:
- 🤖 just-debian - Compilações de lançamento mais recente
🔗 Pacotes relacionados
Também disponíveis no deb.griffo.io:
- fzf Fuzzy Finder - Impulsiona o
just --choosepara seleção interativa de receitas - Jujutsu - Um sistema de controle de versão moderno e compatível com Git
- Editor Helix - Um editor modal pós-moderno para editar seus justfiles