convez.ai
AgenteDevOps & InfraestruturaAvançado
yunsii

WezDeck

yunsii/wezdeck

Flight deck para gerenciar múltiplos agentes IA em um espaço de trabalho unificado

Ver no GitHub
InicialPluginScore · de 0 a 100

Plataforma 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/wezdeck

1 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

Estrelas
4
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 1 dia
Versão
wezdeck-runtime-v2026.11.10.1
Issues abertas
1
Contribuidores
2

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.json pipeline.
  • 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/h carves out a new linked worktree (with its own agent) without leaving the keyboard.
  • Manifest-driven hotkeys — wezterm-x/commands/manifest.json is the single source of truth; per-machine overrides live in wezterm-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

RequiredNotes
WezTermnightlyhybrid-wsl mode runs on the Windows nightly build
tmux≥ 3.6DEC mode 2026 (synchronized output); 3.4 deadlocks. Ubuntu 24.04 still ships 3.4 — build from source. Why
lua5.4recommendedPowers the sync precheck; missing → precheck skipped with a warning
jqrecommendedAgent-attention writer & focus path; missing → degraded labels
go ≥ 1.21optionalFor maintainers of native/picker/. End users get a sha256-pinned prebuilt tarball via the release fetcher
python3optionalOnly 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.

Ver o original no GitHub

Bom para

Relacionados