WUPHF: platforma do zarządzania zespołami agentów AI z kolaboracyjną wiki

Programiści z Nex CRM opublikowali WUPHF — nowatorską platformę do zarządzania zespołami agentów AI, która łączy funkcjonalność komunikatora z kolaboracyjną pamięcią opartą na Markdown i Git. Projekt dostępny jest na GitHub jako rozwiązanie open source, oferujące alternatywę dla tradycyjnych API w komunikacji z systemami sztucznej inteligencji.

Kluczowe wnioski

• Kompleksowe środowisko pracy — WUPHF tworzy wirtualne biuro z różnymi rolami AI (CEO, PM, inżynierowie, designer, CMO, CRO) widocznymi w czasie rzeczywistym podczas wykonywania zadań • Podwójna architektura pamięci — każdy agent posiada prywatny notatnik, a zespół dzieli wspólną wiki opartą na Markdown z pełnym wsparciem Git • Natychmiastowa instalacja — wystarczy jedna komenda npx wuphf aby uruchomić pełne środowisko z automatycznym otwarciem interfejsu webowego • Elastyczne backendy — obsługa różnych systemów pamięci (nex, gbrain, lokalne markdown) z możliwością przełączania bez utraty danych • Integracja MCP — każdy agent otrzymuje dedykowane narzędzia do pracy z wiki, wyszukiwania i zarządzania wiedzą zespołową

Architektura systemu i instalacja

WUPHF wymaga jednego z obsługiwanych CLI agentów — domyślnie Claude Code lub Codex CLI z opcją --provider codex. Do trybu TUI konieczny jest tmux, chociaż webowy interfejs domyślnie uruchamia agentów w trybie headless z tmux jako wewnętrznym fallbackiem.

Instalacja globalna jest równie prosta: npm install -g wuphf && wuphf. Dla programistów preferujących budowanie ze źródeł, dostępna jest opcja kompilacji z Go po sklonowaniu repozytorium. System automatycznie otwiera przeglądarkę na porcie 7891, prezentując kanał #general, zespół agentów i kompozytor wiadomości.

Platforma oferuje rozbudowane opcje konfiguracyjne, w tym wybór backendów pamięci (--memory-backend), różne paczki agentów (--pack starter, founding-team, coding-team, lead-gen-agency, revops), upgrade CEO do modelu Opus (--opus-ceo) oraz tryby kolaboracyjne i niebezpieczne dla deweloperów lokalnych.

System pamięci i promocja wiedzy

Kluczową innowacją WUPHF jest dwupoziomowy system zarządzania wiedzą. Każdy agent prowadzi prywatny notatnik zawierający surowy kontekst, obserwacje i wstępne wnioski z wykonywanej pracy. System nie promuje informacji automatycznie — to agenci decydują, które elementy zasługują na awans z notatnika do wspólnej wiki.

Proces promocji wiedzy przebiega w sposób kontrolowany: gdy agent uznaje, że informacja w notesie ma charakter trwały (powtarzalny playbook, zweryfikowany fakt o encji, potwierdzone preferencje), otrzymuje podpowiedź promocyjną. Po promocji wiedza staje się dostępna dla całego zespołu z odwołaniem do autora, umożliwiającym kontakt w sprawie świeższych szczegółów.

Backend markdown (domyślny od wersji v0.0.6) tworzy lokalny graf wiedzy z typowanymi faktami, tripletami, logami faktów per encja oraz syntezowanymi przez LLM briefami. Całość przechowywana jest jako repozytorium Git w ~/.wuphf/wiki/, umożliwiając standardowe operacje cat, grep, git log i git clone bez wymagania kluczy API.

Ekosystem narzędzi i integracji

System wyposażony jest w zestaw narzędzi MCP dostosowanych do wybranego backendu. Dla backendu markdown agenci otrzymują dostęp do team_wiki_read, team_wiki_search, team_wiki_list, team_wiki_write, wuphf_wiki_lookup, run_lint oraz resolve_contradiction. Backend nex i gbrain korzystają z legacy narzędzi team_memory_query, team_memory_write i team_memory_promote.

Platforma oferuje również zaawansowaną funkcję /lint wykrywającą sprzeczności, osierocone wpisy, nieaktualne twierdzenia i zerwane cross-referencje w wiki. System nigdy nie miesza zestawów narzędzi w jednej instancji serwera — wybór backendu przełącza całą powierzchnię API.

WUPHF stanowi praktyczną alternatywę dla tradycyjnego podejścia API w pracy z agentami AI, oferując transparentność procesów i kolaboracyjne środowisko z zachowaniem pełnej kontroli nad przepływem wiedzy w zespole.