WezDeck
yunsii/wezdeck
Flight deck para gerenciar múltiplos agentes IA em um espaço de trabalho unificado
Ver no GitHubPlataforma de controle multi-agente construída sobre WezTerm, tmux e git worktrees. Oferece uma interface integrada onde cada aba WezTerm é um repositório, cada janela tmux é uma worktree vinculada e cada painel hospeda um agente CLI (Claude, Codex, etc). Inclui rastreamento de atenção em tempo real com badges e navegação por keystroke único.
Instalação
npx convez-ai yunsii/wezdeck1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Executar múltiplos agentes IA em paralelo com interface centralizada
- Navegar rapidamente entre tarefas pendentes de diferentes repositórios
- Gerenciar worktrees git vinculadas com panes tmux dedicadas por agente
- Monitorar status agregado de múltiplos agentes com badges e counters ao vivo
Veredito

WezDeck é uma ferramenta sofisticada e opinionada para operadores que já dominam WezTerm e tmux, resolvendo um problema real na orquestração de múltiplos agentes IA. Exige setup inicial robusto (WezTerm nightly, tmux 3.6+, Lua), mas oferece fluxo de trabalho altamente integrado e eficiente.
README
A tradução para o português deste README ainda está na fila.
One WezTerm tab per repo. One tmux window per worktree. One pane per agent. One keystroke to find what's waiting on you.
This repository is the source of truth for the WezDeck runtime. The GitHub repo is yunsii/wezdeck (the previous yunsii/wezterm-config URL still works via GitHub's permanent redirect).
✨ Highlights
- Tab × Worktree × Agent in one frame — every WezTerm tab is one repo, every tmux window inside it is a linked git worktree, every pane can host an agent CLI (
claude/codex/ …). - Live attention surface — per-tab badges plus a single right-status counter
⟳ N running ⚠ N waiting ✓ N done, driven by a Claude hook →attention.jsonpipeline. - One keystroke to jump —
Alt+/opens a popup of every pending pane across every tab;Alt+,/Alt+.step through them. - One keystroke to spawn a worktree —
Ctrl+k g d/t/hcarves out a new linked worktree (with its own agent) without leaving the keyboard. - Manifest-driven hotkeys —
wezterm-x/commands/manifest.jsonis the single source of truth; per-machine overrides live inwezterm-x/local/keybindings.lua.
📺 Demo
Six mock projects (cli-parser / image-resizer / log-daemon, two worktrees each), all driving the real attention pipeline. Right-status ⟳ 2 ⚠ 5 ✓ 1 aggregates across the workspace; tab badges flip per pane; the focused agent is paused on a permission prompt — the rest are still streaming or have completed. Reproduce: see assets/demo/README.md.
🧭 How It Works
WezTerm tab ─┐
└─ tmux window ─┤ one repo · one worktree · one agent
└─ tmux pane ─┘
↑
Claude hook → attention.json → tab badges + right-status counter
↑
Alt+/ jumps to next pending pane
Full architecture, ownership boundaries, and the WSL ⇄ Windows communication channels: docs/architecture.md.
✅ Requirements
| Required | Notes | |
|---|---|---|
| WezTerm | nightly | hybrid-wsl mode runs on the Windows nightly build |
| tmux | ≥ 3.6 | DEC mode 2026 (synchronized output); 3.4 deadlocks. Ubuntu 24.04 still ships 3.4 — build from source. Why |
| lua5.4 | recommended | Powers the sync precheck; missing → precheck skipped with a warning |
| jq | recommended | Agent-attention writer & focus path; missing → degraded labels |
| go ≥ 1.21 | optional | For maintainers of native/picker/. End users get a sha256-pinned prebuilt tarball via the release fetcher |
| python3 | optional | Only for WakaTime status |
Supported runtime modes: hybrid-wsl (Windows WezTerm + WSL/tmux) and posix-local (Linux / macOS local).
🚀 Quick Start
# 1. Seed your machine-local config
cp -r wezterm-x/local.example/ wezterm-x/local/
$EDITOR wezterm-x/local/constants.lua # runtime_mode, default_domain, shell, …
$EDITOR wezterm-x/local/shared.env # WAKATIME_API_KEY, MANAGED_AGENT_PROFILE, …
# 2. Sync the runtime into $HOME (writes ~/.wezterm.lua + ~/.wezterm-x/)
skills/wezterm-runtime-sync/scripts/sync-runtime.sh
# 3. Reload WezTerm and confirm the right status shows
# "⟳ 0 ⚠ 0 ✓ 0" — that means the attention pipeline is live.
Full setup walkthrough: docs/setup.md.
📚 Documentation
Get started
Daily use
Internals
Releases
Agent rules: AGENTS.md. Reusable user-level profiles: agent-profiles/.
🎨 Brand
Brand SVGs and the geometric construction notes live in assets/brand/ — see assets/brand/README.md for the asset table and proportional rules.
📄 License
MIT © Yuns. See LICENSE.