Tmux dla agentów AI: szablony 2026

Tmux do orchestracji agentów AI: szablony rozwoju równoległego 2026

W 2026 roku tmux stał się kluczowym narzędziem dla programistów średniego i wyższego poziomu, którzy zarządzają od 4 do 8 równoległymi agentami AI takimi jak Claude Code, Codex CLI czy Gemini CLI. Zamiast graficznych interfejsów używane są czyste skrypty bashowe i okna tmux — po jednym na agenta lub worktree git. Rozwiązanie eliminuje problemy z utratą kontekstu, konfliktami w Git i przeciążeniem kognitywnym. Przedstawiamy trzy szablony z Hacker News: Feature Designs, forking agentów i integrację z worktree.

Dlaczego tmux dominuje w czasach agentów AI

Tmux, stworzony w 2007 roku jako klient-serwerowy multiplexer, idealnie nadaje się do narzędzi terminalowych opartych na AI. Każde okno izoluje proces agenta, zachowuje stan przy przerwanych połączeniach i umożliwia natychmiastowe przełączanie między nimi. Brak zależności od dostawcy, brak ograniczeń liczby agentów. Praktyczny limit to 4–8 okien: więcej prowadzi do spadku jakości rozwiązań z powodu utraty skupienia.

Kluczowy kompromis: tmux nie forkuje procesów, tylko tworzy nowe sesje. Jest to tanie, ale wymaga użycia git worktree, by uniknąć konfliktów w katalogu roboczym. Bez worktree dwa agenty w tym samym repozytorium walczą o pliki — pojawiają się konflikty merge i chaos w stanie git.

Szablon Feature Designs: plan w Markdown + agenci wykonawcy

Manuel Schipper (Staff AI Engineer, Snowflake) deleguje 90% kodowania agentom poprzez strukturalne specyfikacje w formacie Markdown — Feature Designs (FD). Każde okno tmux ma swoją rolę:

• Planner: generuje FD z problemu.
• Worker: implementuje według FD.
• PM: zarządza backlogiem.

FD numerowane są (FD-001...), przechowywane są w docs/features/. Struktura:

• Problem: opis problemu.
• Rozwiązania: opcje z kompromisami (zalety i wady).
• Wybrane rozwiązanie: plan, lista plików.
• Weryfikacja: kroki sprawdzenia.

Przykład FD-051:

FD-051: Klasyfikacja dokumentów wieloetykietowa
Status: Otwarte
Priorytet: Średni
Zasoby: Średnie
Skuteczność: Lepsze wskaźniki recall

## Problem
Dokumenty przychodzą z jedną etykietą, ale często obejmują wiele tematów.

## Rozwiązanie
1. Wartości pewności LLM dla każdej kategorii.
2. Akceptuj >0.90.
3. Druga iteracja dla 0.50–0.90.
4. Przechowuj z wartościami.

## Pliki
- src/classify/multi_label.py
- src/classify/prompts.py
- sql/01_schema.sql

## Weryfikacja
1. Uruchom na środowisku testowym.
2. Sprawdź kondycję.
3. Przeprowadź kontrolę prób.

Cykl życia: Planned → Design → Open → In Progress → Pending Verification → Complete. Automatyzacja przez 6 poleceń slash:

• /fd-new: tworzy FD.
• /fd-status: indeksuje.
• /fd-explore: ładuje kontekst do sesji.
• /fd-deep: uruchamia 4 równoległe agenty (algorytmy/struktura/increment/environment).
• /fd-verify: sprawdza poprawność + commit.
• /fd-close: archiwizuje.

/fd-deep paralelizuje 4 agenty do syntezy pomysłów — inspirowane test-time compute. W ciągu miesięcy: ponad 300 FD. Inicjalizacja: /fd-init tworzy infrastrukturę.

Kompromis: agenci kompresują kontekst, tracąc szczegóły — Schipper ręcznie zapisuje checkpointy w Markdown.

Szablon agent forking: lokalne forki kontekstu

Kausik Gopal (Principal Engineer, Instacart) proponuje forking bez planowania. W bieżącej sesji przechwytywany jest bufor (tmux capture-pane), otoczony znacznikami <context>, a następnie uruchamiany w nowym oknie.

Minimalny skrypt bashowy, niezależny od narzędzia: forking z Claude do Gemini do generowania diagramów. Interaktywnie: kopiuje się ręcznie potrzebne fragmenty z powrotem.

Zalety:

• Niski nakład — forking tylko gdy potrzeba.
• Krzyżowe agenty: Codex → Claude → Gemini.

Wady:

• Brak automatycznego merge.
• Długie forki (>1h) tracą synchronizację z main.

Zastosowanie: poboczne hipotezy, testy równoległe z funkcjonalnością. Skrypt na Gist — 20 linii.

Szablon git worktree + tmux: izolacja katalogów

Sō Ito rozwiązuje konflikty Git: jeden worktree (git worktree add) na agenta, jedno okno tmux na worktree. Nazwa okna = nazwa worktree.

Unikaj pane hell: nie dziel okna po worktree — jedno okno na worktree + pane do shell/Vim.

Narzędzie kage: kage feat-x tworzy worktree, okno i uruchamia Claude Code.

Przykład skryptu agent-worker:

#!/usr/bin/env bash
set -euo pipefail
WORKTREE_NAME="${1:?}"
FD_NUMBER="${2:?}"
WT_PATH="$(git rev-parse --show-toplevel)/../${WORKTREE_NAME}"

git worktree add "$WT_PATH" -b "feat/${WORKTREE_NAME}"
tmux new-window -n "$WORKTREE_NAME" -c "$WT_PATH" \
  "claude --permission-mode acceptEdits 'implement FD-${FD_NUMBER}'"

Minimalny tmux.conf dla agentów

# Prefiks C-a
unbind C-b
set -g prefix C-a
bind C-a send-prefix

# Numeracja od 1
set -g base-index 1
setw -g pane-base-index 1

# Mysz
set -g mouse on

# Historia
set -g history-limit 50000

# Vim w pane
bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R

set -g renumber-windows on

Co ważne

• Maks. 4–8 agentów: więcej prowadzi do utraty skupienia i spadku jakości.
• Git worktree obowiązkowo: izolacja od konfliktów przy 3+ agentach.
• Okno na agenta: pane hell zabija nawigację.
• Checkpointy w Markdown: obejście utraty szczegółów.
• Bash + tmux: zero zależności, niezależne od narzędzia.

— Editorial Team