workdeckGitHub
open source · MIT · macOS, Linux e WSL

O terminal onde você e o agente de IA trabalham lado a lado.

Uma sessão do tmux, uma janela por projeto, o agente num pane ao lado e o que você precisa olhar enquanto ele trabalha: o diff do que ele escreveu e o estado dos seus repositórios.

InstalarVer no GitHub
$git clone https://github.com/thiagofeliperibeiro/workdeck.git && cd workdeck && ./install.sh
workdeck — tmux
shell
~/projetos/web ❯
workdeck1:api2:web3:notas4:painel

cinco comandos

Tudo o que você digita

O resto são atalhos de teclado. Nada de alias para decorar.

$ work

Abre a sessão, uma janela por projeto. Ou volta para ela.

$ ai

Abre o seu agente de IA num pane ao lado, já na pasta do projeto.

$ git review

Mostra o que o agente escreveu, com cor de sintaxe e número de linha.

$ painel

Abre o painel de contexto: branches, mudanças soltas, o que você quiser.

$ workdeck-doctor

Diz o que funciona no seu ambiente e o que não vai funcionar.

por que

Feito para quem trabalha com agentes

O agente escreve código que você precisa ver. Com ele ao lado, o git review roda no pane de baixo sem trocar de contexto.

Qualquer agente de CLI

Claude Code, Codex, Copilot CLI, Aider, Gemini. O workdeck não embute nenhum: abre o comando que você escolher.

Qualquer terminal

Os atalhos são do tmux, não do terminal. macOS e Linux; no Windows, pelo WSL.

A sessão sobrevive

Fechar o terminal, cair a conexão ou reiniciar a máquina. Você volta com work e tudo está onde estava, agente incluso.

Instalação reversível

Cópia de cada arquivo antes do primeiro toque e um manifesto do que foi feito. O --restore devolve tudo byte a byte.

Painéis seus

Qualquer executável que imprima texto vira painel. Containers, CI, tarefas do dia. Sem reinstalar nada.

Temas com contraste medido

Catppuccin Mocha, Nord e Min Dark, com verde e vermelho separados também em luminosidade, para ler diff sem cansar.

teclado

Atalhos em Alt, em qualquer terminal

Quem interpreta é o tmux, não o terminal. As ações usam Shift porque Alt com letra minúscula já é do readline: Alt+b, Alt+f e Alt+d andam e apagam palavras no shell.

Navegar
  • Vai direto para a janela NAlt+1…9
  • Pula entre os painéisAlt+←↑↓→
  • Janela anterior / próximaAlt+Shift+← →
Prefere cmd no Mac?

No macOS, o cmd nunca chega ao tmux: o sistema intercepta antes. Há adaptadores prontos para kitty, WezTerm e Alacritty que traduzem cmd+1 em Alt+1. Só o kitty é instalado automaticamente:

./install.sh --terminal kitty
Agir
  • Abre o agente ao ladoAlt+Shift+A
  • Nova janela, na pasta atualAlt+Shift+T
  • Divide lado a ladoAlt+Shift+D
  • Divide em cima/embaixoAlt+Shift+S
  • Zoom: o painel ocupa a janelaAlt+Shift+Z
  • Fecha o painelAlt+Shift+X
  • Renomeia a janelaAlt+Shift+R
  • Solta a sessão, que continua vivaAlt+Shift+E

cores

Três temas para começar

Em fundo escuro, texto acima de 11:1 cansa em sessão longa. Vermelho e verde precisam se separar também em luminosidade, senão o diff fica difícil de ler.

~/projetos/api ❯ git review
git review main
src/server.ts | 4 +++-
8 │ app.listen(port)
- 9 │ console.log("ok")
+ 9 │ logger.info({ port }, "servidor no ar")
+10 │ await ready()
! 1 arquivo +3 -1
workdeck1:api2:web3:notas

instalar

Um script, e ele desfaz o que fez

O instalador detecta o sistema e o gerenciador de pacotes e instala o que faltar: tmux e git-delta. É idempotente; rodar de novo atualiza em vez de duplicar.

  1. 1
    $ git clone https://github.com/thiagofeliperibeiro/workdeck.git
  2. 2
    $ cd workdeck && ./install.sh
    # brew instala tmux e git-delta se faltarem
  3. 3
    $ $EDITOR ~/.config/workdeck/projects.conf
    # seus projetos, uma linha por janela
  4. 4
    $ source ~/.zshrc && work

Desinstalar devolve tudo

Antes de tocar num arquivo pela primeira vez, o instalador guarda uma cópia e anota o que fez num manifesto. Seu .tmux.conf e seu .zshrc voltam byte a byte.

./uninstall.sh
Tira os blocos e os scripts. Sua config fica.
./uninstall.sh --restore
Devolve os arquivos ao estado de antes da instalação.
./uninstall.sh --all
Remove tudo, inclusive ~/.config/workdeck.
./uninstall.sh --dry-run
Mostra o que faria, sem escrever nada.

Antes de abrir uma issue, rode workdeck-doctor: ele diz se o tmux e o delta estão instalados, se o terminal suporta cores de 24 bits, se há um agente configurado e se o ~/.local/bin está no PATH.

Um ponto de partida, não um produto.

Ele não traz os seus projetos, os seus painéis nem o seu tema: traz a estrutura para você montar os seus. Use, copie, dê fork, mude o que precisar.

$git clone https://github.com/thiagofeliperibeiro/workdeck.git && cd workdeck && ./install.sh