O workmux está nos repositórios oficiais do Debian?

Não, workmux não está empacotado nos arquivos oficiais do Debian. Este repositório é atualmente a única fonte apt, oferecendo workmux 0.1.245.

Como instalo o workmux mais recente no Debian?

Adicione o repositório deb.griffo.io uma única vez com as instruções acima e execute: sudo apt install workmux. Novos lançamentos chegam pelo sudo apt upgrade normal.

Os pacotes são assinados e como são construídos?

Cada pacote é assinado com a chave GPG do repositório (EA0F721D231FDD3A0A17B9AC7808B4DD62C41256) e construído a partir de lançamentos upstream em repositórios públicos do GitHub que qualquer pessoa pode inspecionar.

Quais versões do Debian são suportadas?

Debian 12 Bookworm, Debian 13 Trixie, Forky e Sid.

Instalar o workmux no Debian via apt

Fonte	Versão
deb.griffo.io	0.1.245 ✅
Debian oficial	🚫 não empacotado

← Voltar ao início

📌 Instalando em uma versão específica? Debian 12 (bookworm) · Debian 13 (trixie) · Debian 14 (forky) · Debian Sid

O que é o workmux?

O workmux transforma uma branch em um espaço de trabalho. Um único workmux add cria um worktree do git, abre a janela do tmux correspondente, copia os arquivos que faltam em um checkout novo (.env, credenciais), cria links para os que você não quer reinstalar (node_modules), roda seus comandos de preparação e monta o layout de painéis que você pediu. O workmux merge desfaz tudo de uma vez: mescla a branch, apaga o worktree, fecha a janela e remove a branch local. Sem stash, sem trocar de branch, sem um checkout pela metade travando a próxima tarefa.

            🚀 Por que a versão mais recente importa: O workmux lança várias versões por semana, e a maioria trata das ferramentas que ele controla: quais agentes de código consegue acompanhar, como o status deles é reportado, quais multiplexadores de terminal são suportados e o que o dashboard e a barra lateral mostram. Uma integração adicionada na semana passada só existe no binário da semana passada. Nem o Debian nem o Ubuntu empacotam o workmux, então uma build atual não é um luxo aqui: é a única forma de tê-lo via apt.
        

⚡ Principais recursos do workmux

🌿 Uma janela por branch

O workmux add cria o worktree e a janela do tmux juntos, então trocar de tarefa é trocar de aba, com shell, editor e servidor de desenvolvimento próprios.

🧰 Worktrees que realmente funcionam

Worktrees novos nascem quebrados. O workmux copia arquivos de configuração, cria links para dependências e roda seus comandos post_create para que o novo checkout seja utilizável na hora.

🤖 Agentes em paralelo

Rode vários agentes de código ao mesmo tempo, um por worktree, e acompanhe o status no nome da janela do tmux, num dashboard TUI ou numa barra lateral ao vivo.

🧹 Limpeza com um comando

O workmux merge mescla a branch e depois remove o worktree, a janela do tmux e a branch local; o workmux remove faz a limpeza sem mesclar.

📄 Configurado em YAML

Um config.yaml global para os seus padrões e um .workmux.yaml por projeto para layouts de painéis, hooks e operações de arquivo, com aninhamento pensado para monorepos.

🖥️ Não só tmux

O tmux é o backend padrão, e kitty, WezTerm e Zellij são alternativas suportadas, então o fluxo acompanha o terminal que você já usa.

            🚀 Sempre à frente dos arquivos oficiais: Debian e Ubuntu congelam as versões dos pacotes quando lançam uma release — este repositório publica novas versões upstream normalmente em poucas horas. Um simples apt upgrade mantém você na versão mais recente.
        

📦 Instalação a partir do deb.griffo.io

Executar os comandos

Passo 1: Adicionar o 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 update

install -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 update

sudo 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; workmux não está entre elas, então o repositório acima é a única forma de instalar hoje — peça e ela pode ser adicionada.

Como funciona o espelho gratuito →

🧩 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 workmux

# Instalar o workmux mais recente
sudo apt install workmux

# O tmux é o backend padrão e vem apenas como recomendado,
# porque kitty, WezTerm e Zellij também funcionam
sudo apt install tmux

# Verificar a instalação
workmux --version

# Instalar o workmux mais recente
apt install workmux

# O tmux é o backend padrão e vem apenas como recomendado,
# porque kitty, WezTerm e Zellij também funcionam
apt install tmux

# Verificar a instalação
workmux --version

Passo 3: O primeiro worktree

# Opcional: escrever um .workmux.yaml para este projeto
cd ~/src/meu-projeto
workmux init

# De dentro do tmux: branch, worktree, janela e painéis em um comando
workmux add nova-funcionalidade

# Quando o trabalho terminar: mesclar e limpar tudo
workmux merge

# As conclusões de bash, zsh e fish vêm no pacote
workmux --help

🎯 Exemplos básicos de uso

O ciclo do dia a dia:

# Criar uma branch, um worktree e uma janela do tmux
workmux add fix-login

# Uma branch existente é reconhecida pelo nome
workmux add trabalho-existente

# Partir de uma base diferente da padrão
workmux add hotfix --base production

# Trazer um pull request para o próprio worktree
workmux add --pr 123

# Ver tudo o que está em andamento
workmux list

# Mesclar e desmontar tudo
workmux merge

# Ou descartar o trabalho sem mesclar
workmux remove fix-login

Janelas, painéis e recuperação:

# Criar a janela sem mudar para ela
workmux add revisao-docs --background

# Fechar uma janela mantendo o worktree e a branch
workmux close revisao-docs

# Abrir de novo mais tarde
workmux open revisao-docs

# Reconstruir todas as janelas após uma queda do tmux ou da máquina
workmux resurrect

# Entrar num worktree de qualquer lugar
cd "$(workmux path fix-login)"

Rodando agentes em paralelo:

# Instalar os hooks de status e as skills do seu agente
workmux setup

# Iniciar um worktree com um prompt para o agente
workmux add add-tests --prompt "Adicione testes unitários para o parser"

# Acompanhar todos os agentes em uma TUI
workmux dashboard

# Ou manter uma barra lateral de status no tmux
workmux sidebar

# Enviar uma instrução para um agente em execução
workmux send add-tests "Cubra também os caminhos de erro"

# Esperar até esse agente terminar
workmux wait add-tests

🔧 Integrações

O workmux se apoia de propósito nas ferramentas que você já usa:

git: worktrees são checkouts comuns de git worktree, então git, seus hooks e seu CI não veem nada diferente
tmux: uma janela por worktree, nomeada a partir da branch, com o seu layout de painéis aplicado automaticamente
kitty, WezTerm e Zellij: backends alternativos suportados, se o tmux não for o seu multiplexador
Agentes de código: acompanhamento de status, injeção de prompts e skills para o Claude Code e os demais agentes suportados pelo upstream
Seu shell: as conclusões de bash, zsh e fish vêm neste pacote, e alias wm='workmux' é o atalho recomendado pelo upstream

🚀 Por que escolher o deb.griffo.io?

📊 Comparativo de repositórios:

Debian oficial: não empacota o workmux — apt install workmux falha num sistema padrão
cargo install workmux: atualizado, mas é compilar Rust em cada máquina, fora do apt e sem as conclusões de shell
O script de instalação upstream: prático, mas escreve no seu sistema pelas costas do gerenciador de pacotes e se atualiza no próprio ritmo
deb.griffo.io: versão mais recente com atualizações automáticas

✅ A única fonte apt: o workmux não está nos arquivos do Debian nem do Ubuntu; este repositório empacota a build oficial upstream
✅ O suporte a agentes muda toda semana: quais agentes o workmux consegue acompanhar e controlar muda a cada lançamento, então estar atualizado é a diferença entre o recurso funcionar e não existir
✅ Atualizações automáticas: os pacotes são atualizados poucas horas após cada lançamento upstream
✅ Pacote completo: o binário upstream em /usr/bin/workmux, mais as conclusões de bash, zsh e fish
✅ Dependências honestas: o pacote depende de git e recomenda tmux, porque kitty, WezTerm e Zellij também são backends suportados
✅ Duas arquiteturas: amd64 e arm64, ambas com ligação estática, então o mesmo pacote roda em todas as suítes
✅ Multi-distribuição: funciona no Bookworm, Trixie, Forky e Sid
✅ Manutenção simples: atualizações com os comandos apt de sempre

📦 Repositório de build do pacote

Os pacotes Debian são construídos e mantidos automaticamente neste repositório do GitHub:

🧩 workmux-debian - Builds dos últimos lançamentos

🔗 Pacotes relacionados

Também disponíveis no deb.griffo.io:

lazygit - Interface git de terminal para o trabalho dentro de cada worktree
GitUI - Outro cliente git de terminal rápido, se você preferir o modelo dele
Zellij - Alternativa suportada ao tmux como backend multiplexador
Serie - Grafo de commits para revisar o que uma branch realmente fez

            🎯 Ideal para: revisar um pull request sem perder o checkout atual, rodar três agentes de código em três funcionalidades ao mesmo tempo, manter viva uma branch longa de migração ao lado do trabalho diário e nunca mais dar stash só para responder «dá uma olhada rápida nisso?».
        

🧩 Instalar o workmux mais recente no Debian