---
title: "Zacznij tutaj: czym jest Monolynx i czego potrzebujesz"
description: "Pierwszy wpis do przeczytania: czym jest Monolynx, jak założyć konto, czego potrzebujesz na komputerze, ile to kosztuje i w jakiej kolejności czytać pozostałe wpisy."
url: "https://monolynx.com/blog/zacznij-tutaj-monolynx"
lang: "pl"
author: "Zespół Monolynx"
published: "2026-10-10T12:04:54.436347+00:00"
modified: "2026-10-10T13:13:01.065261+00:00"
last_verified: "2026-10-10"
tags: ["monolynx", "plugin", "claude-code", "open-source"]
translations: []
reading_time_minutes: 11
word_count: 2013
---

> [!TLDR]
> - Monolynx to otwarta platforma do prowadzenia projektu z agentami AI: tickety, sprinty, wiki, graf kodu i podgląd pracy agentów w jednym miejscu.
> - Konto na monolynx.com zakłada każdy. Logujesz się kontem Google, a pierwsze logowanie tworzy konto.
> - Kod jest na licencji MIT, w GitLabie i GitHubie. Własną instancję stawiasz jednym plikiem Docker Compose.
> - Platforma nic nie kosztuje. Płacisz za modele, z których korzysta Twój agent, w ramach własnego planu Claude Code albo Codex.
> - Do pierwszego ticketu wystarczą konto, Claude Code i repozytorium git. Narzędzia `glab` i `gh` są potrzebne dopiero do automatycznych merge requestów.

## 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.


**Statystyki**

- **24** - komendy pluginu, od konfiguracji po zamknięcie sprintu
- **3** - kanały do tych samych danych: panel, serwer MCP i CLI
- **0** - opłat za samą platformę



**Porównanie**

| Element | Co to jest | Gdzie działa |
| --- | --- | --- |
| Panel | aplikacja z ticketami, sprintami i wiki | przeglądarka, `https://monolynx.com` albo własna instancja |
| Serwer MCP | połączenie, przez które agent czyta i zapisuje dane | adres `/mcp` tej samej instancji |
| Plugin | komendy `/monolynx:*`, agenci ról i strażnik komend | Claude Code albo Codex na Twoim komputerze |
| CLI `monolynx` | szybszy kanał do tych samych danych, opcjonalny | terminal |


## Jak dostać konto?

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


**Porównanie**

| Droga | Jak założyć konto | Kiedy ją wybrać |
| --- | --- | --- |
| monolynx.com | wejdź na stronę logowania i wybierz logowanie kontem Google; pierwsze logowanie tworzy konto | chcesz zacząć od razu, bez serwera |
| własna instancja | administrator instancji zaprasza Cię mailem albo włącza logowanie Google | dane mają zostać na Twojej infrastrukturze |


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](https://monolynx.com/blog/pierwszy-projekt-w-monolynx).

### Własna instancja

Kod źródłowy jest publiczny: [repozytorium Monolynx w GitLabie](https://gitlab.com/piotrkrych/monolynx) i [kopia repozytorium Monolynx w GitHubie](https://github.com/piotrkrych2/monolynx). Licencja MIT pozwala go używać, zmieniać i wdrażać u siebie.


**Środowisko deweloperskie na własnym komputerze**

```console
$ 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.


**Porównanie**

| Zmienna | Do czego służy | Wymagana |
| --- | --- | --- |
| `SECRET_KEY` | podpisuje sesje logowania | tak |
| `POSTGRES_PASSWORD` | hasło bazy danych | tak |
| `APP_URL` | publiczny adres instancji | tak |
| `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET` | logowanie kontem Google | nie; puste wyłączają to logowanie |
| `OPENAI_API_KEY` | wyszukiwanie semantyczne w wiki | nie; bez niej wiki działa bez wyszukiwania po znaczeniu |


> [!NOTE]
> Plugin ma wpisany adres `https://monolynx.com/mcp`. Na własnej instancji połączenie MCP dodajesz ręcznie, z adresem `/mcp` swojej instancji, a CLI kierujesz zmienną `MONOLYNX_ENDPOINT`. Zmienne opisuje wpis [Konfiguracja: która zmienna w którym pliku](https://monolynx.com/blog/konfiguracja-monolynx-zmienne).

## 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ą.


**Porównanie**

| Narzędzie | Pierwszy ticket | Sprint z pętlami | Uwagi |
| --- | --- | --- | --- |
| Konto i projekt w Monolynx | tak | tak | agent działa z Twoimi uprawnieniami |
| Claude Code albo Codex CLI | tak | tak | plugin sprawdzono na Claude Code 2.1.273 i Codex CLI 0.154.0; starszych wersji nie testowano |
| Repozytorium git | tak | tak | komendy pracują na branchach |
| Python 3.10 lub nowszy | tak | tak | uruchamia skrypty pomocnicze pluginu i strażnika komend |
| `glab` albo `gh`, zalogowane | nie | tak | kolejka merge requestów czyta przez nie stan CI i merguje |
| Bash | nie | tylko dla skryptu pętli | pętlę możesz też prowadzić komendą `/loop` w Claude Code |
| CI w repozytorium | nie | potrzebne kolejce | bez CI dyspozytor i sesje działają, a merge robisz sam |
| CLI `monolynx` | nie | nie | opcjonalny, szybszy kanał; instalacja przez `pipx install monolynx-cli` albo Homebrew |


> [!IMPORTANT]
> Komenda `work` sama otwiera merge request tylko w GitLabie, przez `glab`. W GitHubie pull request otwierasz sam, a kolejka `mr-queue` prowadzi go dalej przez `gh`. Na innej platformie merge requesty prowadzisz ręcznie.

### 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.


**Porównanie**

| Co robisz | Co zużywa model |
| --- | --- |
| jeden ticket komendą `work-simple` | jedna sesja, jeden programista i krytyk |
| jeden ticket komendą `work` | sesja koordynatora, Researcher, kilku agentów i krytyk |
| sprint z pętlami | osobna sesja na każdy ticket, do liczby slotów naraz, plus tick dyspozytora i kolejki co kilkanaście minut |


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.


**Kroki**

1. **Załóż konto i projekt** [Pierwszy projekt w Monolynx](https://monolynx.com/blog/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](https://monolynx.com/blog/polaczenie-z-monolynx-mcp-claude-code-chatgpt) rozwija krok trzeci poprzedniego wpisu: połączenie MCP, plugin i logowanie.
3. **Zapisz komendy lintu i testów** [Strona toolchain i /monolynx:setup](https://monolynx.com/blog/strona-toolchain-i-monolynx-setup) opisuje jedyną konfigurację wymaganą przed pierwszym ticketem.
4. **Zrób jeden ticket** [Pierwszy ticket ręcznie](https://monolynx.com/blog/pierwszy-ticket-recznie-monolynx) podaje sześć kroków bez sprintu i bez flag, a [Od pustego repozytorium do zmergowanego ticketu](https://monolynx.com/blog/od-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](https://monolynx.com/blog/statusy-ticketu-w-monolynx) oraz [Zatwierdzanie i merge: co zawsze robi człowiek](https://monolynx.com/blog/zatwierdzanie-i-merge-w-monolynx).
6. **Zaplanuj sprint w panelu** [Sprint w panelu Monolynx](https://monolynx.com/blog/sprint-w-panelu-monolynx) pokazuje backlog, tablicę i start sprintu, a [Konfiguracja: która zmienna w którym pliku](https://monolynx.com/blog/konfiguracja-monolynx-zmienne) mówi, gdzie zapisać zgody.
7. **Zrób test dymny** [Test dymny przed pierwszym sprintem](https://monolynx.com/blog/test-dymny-przed-sprintem-monolynx) 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](https://monolynx.com/blog/sprint-lista-kontrolna-monolynx), potem przewodnik [Sprint z Monolynx krok po kroku](https://monolynx.com/blog/sprint-z-monolynx-krok-po-kroku), a obok [Sesje w tle: jak obserwować pętle sprintu](https://monolynx.com/blog/sesje-w-tle-monolynx). Na co dzień wystarcza jedna strona: [Dzień sprintu: ściąga i tabela decyzji](https://monolynx.com/blog/dzien-sprintu-monolynx).
9. **Miej pod ręką plan na odstępstwa** [Praca ręczna w trakcie sprintu](https://monolynx.com/blog/praca-reczna-w-sprincie-monolynx), [Awaryjnie: jak zatrzymać sprint i posprzątać](https://monolynx.com/blog/awaryjne-zatrzymanie-sprintu-monolynx) oraz [Gdy coś nie działa w Monolynx](https://monolynx.com/blog/gdy-cos-nie-dziala-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](https://monolynx.com/blog/jak-dziala-monolynx-ticket-create), [Jak działa /monolynx:ticket-review](https://monolynx.com/blog/jak-dziala-monolynx-ticket-review), [Jak działa /monolynx:work](https://monolynx.com/blog/jak-dziala-monolynx-work), [Jak działa /monolynx:sprint-run](https://monolynx.com/blog/jak-dziala-monolynx-sprint-run), [Jak działa /monolynx:mr-queue](https://monolynx.com/blog/jak-dziala-monolynx-mr-queue), [Jak działa /monolynx:sprint-end](https://monolynx.com/blog/jak-dziala-monolynx-sprint-end) i [Jak działają skille LLM Wiki](https://monolynx.com/blog/jak-dzialaja-skille-llm-wiki). Dwa wpisy są poza ścieżką, bo dotyczą narzędzi opcjonalnych: [Monolynx CLI dla deweloperów i agentów](https://monolynx.com/blog/monolynx-cli-dla-deweloperow-i-agentow) oraz [Graf kodu i testy mutacyjne](https://monolynx.com/blog/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.


**Porównanie**

| Słowo | Znaczenie pierwsze | Znaczenie drugie |
| --- | --- | --- |
| pipeline | przebieg CI na platformie, na przykład pipeline merge requesta | zapis pracy agentów w module Pipelines |
| kolejka | komenda `mr-queue`, która prowadzi merge requesty | kolejka testów: blokada, przez którą sesje uruchamiają testy po kolei |
| review | status ticketu Review, czyli praca czeka na merge | ocena: krytyka w komendzie `work` albo człowieka w merge requeście |
| done | status ticketu Gotowe, czyli zmiana zmergowana | licznik `done=` w linii statusu pętli |
| branch bazowy, źródłowy, docelowy, integracyjny | w sprincie: zawsze branch sprintu | w pracy ręcznej: gałąź główna |
| komenda, skill | to samo: polecenie `/monolynx:*` | - |


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


**Porównanie**

| Słowo | Gdzie występuje | Co tam znaczy |
| --- | --- | --- |
| `auto` | `MONOLYNX_SPRINT_PERMISSION_MODE` | tryb uprawnień Claude Code dla sesji w tle: bezpieczne polecenia przechodzą, pozostałe są odrzucane |
| `auto` | `MONOLYNX_CONTRACT` | komenda `work` zapisuje kontrakt pracy i idzie dalej bez Twojego potwierdzenia |
| `auto` | `MONOLYNX_BRIEF_GUARD` | gołe polecenie na początku sesji dostaje propozycję kontraktu |
| `needs_human` | raport dyspozytora `sprint-run` | ticket bez żywej sesji, który nie jest ani Do zrobienia, ani Review, ani Gotowe: sesja padła bez wyniku albo ticket ma status Backlog lub W trakcie; dyspozytor raz uruchamia go sam |
| `needs_human` | raport kolejki `mr-queue` | merge request, którego kolejka nie poprowadzi sama: brak pipeline'u, pipeline anulowany, draft albo dwie nieudane naprawy |
| tryb | komenda `work` | zmiana albo naprawa defektu |
| tryb | strona `toolchain`, pole `pełny przebieg` | pełne testy lokalnie albo w CI |
| tryb | `MONOLYNX_BRANCH_MODE` | reguła nazwy brancha ticketu w pracy ręcznej |
| tryb | sesja | interaktywna, z człowiekiem, albo w tle, bez człowieka |
| gałąź główna | wszystkie wpisy | branch, do którego trafia skończony sprint: domyślny branch repozytorium, zwykle `main`, a w części projektów `develop` |


Wszystkie komendy i wspólny słownik pojęć zbiera [Mapa pluginu Monolynx](https://monolynx.com/blog/mapa-pluginu-monolynx). Wracaj do niej, gdy jakieś słowo jest niejasne.

## Najczęstsze pytania


**FAQ**

### Czy muszę stawiać własny serwer?
Nie. Na monolynx.com zakładasz konto i projekt od razu. Własna instancja ma sens, gdy dane projektu nie mogą opuścić Twojej infrastruktury.

### Czy Monolynx działa bez Claude Code?
Panel działa samodzielnie jako narzędzie do ticketów, sprintów i wiki. Komendy `/monolynx:*` wymagają Claude Code albo Codex. Inne aplikacje z obsługą MCP, na przykład ChatGPT, mogą czytać i zapisywać dane, ale nie uruchomią komend pluginu.

### Czy agent zobaczy wszystkie moje projekty?
Agent widzi to samo co Twoje konto. W projekcie, w którym masz rolę tylko do odczytu, niczego nie zapisze.

### Czy potrzebuję CI?
Do pracy nad jednym ticketem nie. Kolejka `mr-queue` merguje dopiero po zielonym CI, więc w repozytorium bez CI merge robisz sam.

### Czy mogę używać Monolynx z repozytorium na Bitbuckecie?
Tak, z ograniczeniem. Tickety, komenda `work`, wiki i dyspozytor działają na każdym repozytorium git. Automatyczne otwieranie merge requestów działa tylko w GitLabie, a kolejka obsługuje GitLab i GitHub.


## Słownik i następny krok


**Słownik**

- **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](https://monolynx.com/blog/pierwszy-projekt-w-monolynx).


**Wezwanie do działania**

Chcesz zacząć bez instalowania czegokolwiek na serwerze?

[Załóż konto na monolynx.com](https://monolynx.com/auth/login)