Zacznij tutaj: czym jest Monolynx i czego potrzebujesz

Czym jest Monolynx?

Monolynx łączy dwie rzeczy. Pierwsza to aplikacja w przeglądarce: tickety, sprinty, tablica, wiki, graf zależności kodu, monitoring i podgląd pracy agentów. Druga to plugin do Claude Code, czyli 24 komendy /monolynx:*, którymi agent AI czyta i zapisuje te same dane.

Dzięki temu agent pracuje na tym samym projekcie co Ty. Bierze ticket, pisze kod, uruchamia testy i zostawia w tickecie plan, raporty i ocenę. Decyzje, które wymagają odpowiedzialności, zostają przy człowieku: zatwierdzenie zmiany i merge do gałęzi głównej.

Jak dostać konto?

Są dwie drogi i obie prowadzą do tego samego panelu.

Po zalogowaniu tworzysz projekt i zostajesz jego właścicielem. Kolejne osoby zapraszasz w ustawieniach projektu. Krok po kroku opisuje to wpis Pierwszy projekt w Monolynx.

Własna instancja

Kod źródłowy jest publiczny: repozytorium Monolynx w GitLabie i kopia repozytorium Monolynx w GitHubie. Licencja MIT pozwala go używać, zmieniać i wdrażać u siebie.

$ git clone https://gitlab.com/piotrkrych/monolynx.git
$ cd monolynx
$ cp .env.example .env
$ make dev
$ make migrate
$ make createsuperuser

Wdrożenie produkcyjne korzysta z pliku docker-compose.prod.yml. Uruchamia on aplikację, osobny proces monitoringu, bazę PostgreSQL, bazę grafową Neo4j i magazyn plików MinIO.

Czego potrzebujesz na komputerze?

Lista zależy od tego, jak daleko chcesz dojść. Pierwszy ticket ma krótką listę, sprint z pętlami dłuższą.

Co to jest /loop?

/loop to komenda samego Claude Code, a nie pluginu. Powtarza inną komendę co zadany czas, na przykład /loop 15m /monolynx:sprint-run. Działa, dopóki sesja jest otwarta, a komputer nie śpi. Na serwerze tę samą pracę wykonuje skrypt sprint_run.sh uruchomiony w tmux albo z crona.

Ile to kosztuje?

Platforma jest darmowa: na monolynx.com i na własnej instancji. Koszt powstaje gdzie indziej, bo każda sesja agenta zużywa model w ramach Twojego planu Claude Code albo Codex.

Wpisy nie podają kwot, bo zależą od planu, modelu i wielkości ticketów. Dwa pokrętła masz w ręku: liczbę równoległych slotów dyspozytora i model sesji w zmiennej MONOLYNX_SPRINT_MODEL. Pierwszy sprint warto puścić na dwóch slotach i sprawdzić zużycie w swoim planie.

Od czego zacząć czytanie?

Wpisy tworzą jedną ścieżkę z dwóch torów. Kroki 1-5 to tor jednego ticketu: po nich umiesz przeprowadzić ticket od opisu do merge. Kroki 6-9 to tor sprintu: wiele ticketów naraz, z pętlami. Każdy krok zakłada, że poprzedni jest zrobiony. Lista wpisów na stronie bloga jest ułożona według daty, więc kolejności nauki szukaj tutaj, a nie tam.

1. Załóż konto i projekt

   Pierwszy projekt w Monolynx prowadzi w pięciu krokach od konta do komendy /monolynx:setup. To wpis główny tego etapu.

2. Połącz agenta

   Jak połączyć agenta AI z Monolynx rozwija krok trzeci poprzedniego wpisu: połączenie MCP, plugin i logowanie.

3. Zapisz komendy lintu i testów

   Strona toolchain i /monolynx:setup opisuje jedyną konfigurację wymaganą przed pierwszym ticketem.

4. Zrób jeden ticket

   Pierwszy ticket ręcznie podaje sześć kroków bez sprintu i bez flag, a Od pustego repozytorium do zmergowanego ticketu pokazuje ten sam przebieg na jednym przykładzie z wynikami komend.

5. Poznaj statusy i rolę człowieka

   Statusy ticketu w Monolynx oraz Zatwierdzanie i merge: co zawsze robi człowiek.

6. Zaplanuj sprint w panelu

   Sprint w panelu Monolynx pokazuje backlog, tablicę i start sprintu, a Konfiguracja: która zmienna w którym pliku mówi, gdzie zapisać zgody.

7. Zrób test dymny

   Test dymny przed pierwszym sprintem sprawdza połączenie, strażnika komend i jeden ticket w tle, zanim włączysz pętle.

8. Uruchom sprint

   Sprint od zera: lista kontrolna i tabela zgodności, potem przewodnik Sprint z Monolynx krok po kroku, a obok Sesje w tle: jak obserwować pętle sprintu. Na co dzień wystarcza jedna strona: Dzień sprintu: ściąga i tabela decyzji.

9. Miej pod ręką plan na odstępstwa

   Praca ręczna w trakcie sprintu, Awaryjnie: jak zatrzymać sprint i posprzątać oraz Gdy coś nie działa w Monolynx.

Każda duża komenda ma też własny wpis, do którego sięgasz, gdy chcesz wiedzieć, co dzieje się pod spodem: Jak działa /monolynx:ticket-create, Jak działa /monolynx:ticket-review, Jak działa /monolynx:work, Jak działa /monolynx:sprint-run, Jak działa /monolynx:mr-queue, Jak działa /monolynx:sprint-end i Jak działają skille LLM Wiki. Dwa wpisy są poza ścieżką, bo dotyczą narzędzi opcjonalnych: Monolynx CLI dla deweloperów i agentów oraz Graf kodu i testy mutacyjne.

Słowa, które znaczą kilka rzeczy

Kilka słów wraca we wpisach w różnych znaczeniach. Znaczenie zawsze wynika z kontekstu podanego w tabeli.

Trzy słowa mają więcej niż dwa znaczenia, zależnie od miejsca, w którym stoją.

Wszystkie komendy i wspólny słownik pojęć zbiera Mapa pluginu Monolynx. Wracaj do niej, gdy jakieś słowo jest niejasne.

Najczęstsze pytania

Słownik i następny krok

Instancja

jedna działająca kopia aplikacji Monolynx: monolynx.com albo Twój własny serwer

Plugin

pakiet komend, agentów i strażnika komend instalowany w Claude Code albo Codex

MCP

protokół, przez który agent AI łączy się z zewnętrznym narzędziem

Slot

miejsce na jedną równoległą sesję ticketu w sprincie

Tick

jedno uruchomienie komendy pętli: sprawdza stan i wykonuje najwyżej kilka działań

Masz konto i narzędzia, więc pora założyć projekt i połączyć z nim agenta. Zrób to z wpisem Pierwszy projekt w Monolynx.