Konfiguracja Monolynx: która zmienna w którym pliku

Gdzie zapisać zmienną, żeby zadziałała?

Plugin czyta ustawienia ze zmiennych środowiskowych o nazwach zaczynających się od MONOLYNX_. Claude Code wstawia je do środowiska sesji z pola env w plikach ustawień projektu. O tym, czy zmienna dotrze do sesji, decyduje miejsce zapisu.

flowchart TD
  A[".claude/settings.json (śledzony)"] --> D["Sesja ticketu w worktree"]
  B["Środowisko dyspozytora"] --> D
  C[".claude/settings.local.json (osobisty)"] -. "nie dociera" .-> D
  C --> E["Twoja sesja w głównym katalogu"]
  A --> E

Co wpisać do pliku śledzonego?

Do pliku śledzonego trafia wszystko, co ma działać tak samo u każdego i w każdej sesji: nazwa projektu i zgody na samodzielne kroki.

{
  "env": {
    "MONOLYNX_PROJECT_SLUG": "twoj-projekt",
    "MONOLYNX_CONTRACT": "auto",
    "MONOLYNX_AUTOTEST": "true",
    "MONOLYNX_AUTOCOMMIT": "true",
    "MONOLYNX_AUTOPUSH": "true",
    "MONOLYNX_AUTOMR": "true"
  }
}

Trzy z tych flag są warunkiem startu sprintu. Bez MONOLYNX_AUTOTEST, MONOLYNX_AUTOCOMMIT i MONOLYNX_AUTOPUSH dyspozytor nie uruchomi żadnej sesji. MONOLYNX_AUTOMR jest zalecana: bez niej branch ticketu zostaje wypchnięty, ale merge request tworzysz sam.

Projekt, w którym pracujesz ręcznie

Bez sprintu z agentami wystarcza znacznie mniej. Poniższy przykład zostawia Ci commit i push, a oddaje agentowi tylko lint i testy.

{
  "env": {
    "MONOLYNX_PROJECT_SLUG": "twoj-projekt",
    "MONOLYNX_AUTOTEST": "true"
  }
}

Czego nie wpisywać do pliku śledzonego?

Trzy zmienne opisują jeden przebieg, a nie projekt. Wpisane do pliku śledzonego trafiłyby po merge do każdej sesji każdej osoby.

$ git switch sprint/eksport-zamowien
$ export MONOLYNX_MR_TARGET=sprint/eksport-zamowien
$ claude
> /loop 15m /monolynx:sprint-run

Sesje ticketów startowane przez dyspozytora dziedziczą jego środowisko, więc każda z nich wie, do którego brancha ma otworzyć merge request. Plik osobisty działa tu tylko pośrednio: czyta go sesja dyspozytora w głównym katalogu i przekazuje wartość dalej, a sama sesja ticketu tego pliku nie widzi. Najpewniejszy jest export w terminalu, z którego startujesz pętle. Kolejka mr-queue bierze branch docelowy z samego merge requesta, więc w jej oknie zmienna nie jest potrzebna. Jeśli ją tam ustawisz, musi mieć tę samą wartość. Katalog, z którego startujesz dyspozytora, musi stać na tym samym branchu, bo worktree ticketu powstaje z jego bieżącego commita.

Zmienne i ich wartości domyślne

Poniższe tabele zbierają zmienne, których używa się najczęściej. Kolumna "Domyślnie" mówi, co się stanie, gdy zmiennej nie ustawisz.

Projekt i zgody

Branche

Sprint i pętle

CLI i skrypty CI

Plugin, CLI i skrypty CI czytają różne zmienne, choć część z nich niesie tę samą informację. Nazwę projektu plugin bierze z MONOLYNX_PROJECT_SLUG, a CLI z MONOLYNX_PROJECT.

Pozostałe

Modele i koszt

Proces uruchomiony bez wskazania modelu bierze domyślny model Twojego konta, a subagent dziedziczy model sesji, która go powołała. Oba zachowania są ciche i prowadzą do tego samego: cały sprint pracuje na najdroższym modelu. Plugin ustawia więc model każdej roli jawnie.

Jak sprawdzić, co jest ustawione?

Nie musisz czytać plików ręcznie. Komenda /monolynx:setup pokazuje każdą flagę z trzech źródeł naraz i ostrzega, gdy flaga jest ustawiona w miejscu, którego sesja w tle nie zobaczy.

1. Uruchom checklistę

   Wpisz /monolynx:setup w katalogu projektu.

2. Przeczytaj punkt o flagach

   Każda flaga ma wartość i źródło: środowisko, plik śledzony albo plik osobisty.

3. Przenieś zgody do pliku śledzonego

   Flagi autonomii z pliku osobistego wpisz do .claude/settings.json i zatwierdź zmianę w gicie.

4. Sprawdź branch

   Gdy MONOLYNX_BASE_BRANCH i MONOLYNX_MR_TARGET są różne, usuń pierwszą.

Najczęstsze pytania

Słownik i następny krok

Plik śledzony

plik zapisany w repozytorium gita, widoczny w każdej kopii roboczej

Plik osobisty

plik ignorowany przez gita, obecny tylko w Twoim katalogu

Środowisko procesu

zmienne dostępne dla uruchomionego programu i programów, które on uruchomi

Flagi autonomii

zmienne MONOLYNX_AUTO*, czyli Twoje zgody na samodzielne kroki agenta

Worktree

osobny katalog roboczy tego samego repozytorium, w którym pracuje sesja ticketu

Kontrola wstępna

sprawdzenie konfiguracji na początku ticku dyspozytora

Konfigurację od zera prowadzi wpis Pierwszy projekt w Monolynx. Objawy błędnej konfiguracji i ich naprawę zbiera wpis Gdy coś nie działa w Monolynx. Wszystkie komendy w jednym miejscu pokazuje Mapa pluginu Monolynx.