rulesync, Ruler czy agentsync: jak trzymać Claude Code i Codex w jednej konfiguracji

👁 116 przeczytań

Kiedy zacząłem pracować równolegle w Claude Code i w Codexie, każda zmiana zasad wymagała dwóch edycji. Dopisywałem regułę do pamięci Claude’a, a potem przypominałem sobie, że Codex jej nie zna. Szukałem więc narzędzia, które trzymałoby jedną wersję zasad, skilli i serwerów MCP, a resztę rozsyłało samo. Znalazłem ich kilka, wszystkie darmowe i na licencji MIT. Żadnego nie zainstalowałem.

Poniżej porównuję cztery najciekawsze i wyjaśniam, dlaczego przy jednej osobie i dwóch narzędziach wystarczył mi krótki skrypt, a przy zespole wybrałbym inaczej.

Jedno źródło prawdy

Wszystkie te narzędzia działają podobnie. Zasady, skille i definicje serwerów MCP trzymasz w jednym miejscu, a program zapisuje je w formatach, których oczekuje każde narzędzie: CLAUDE.md i plik JSON dla Claude Code, AGENTS.md i config.toml dla Codexa, osobne pliki reguł dla Cursora. Różnią się tym, gdzie leży to jedno miejsce, ile narzędzi obsługują i czy rozsyłają kopie, czy linki.

rulesync obsługuje najwięcej: zasady, polecenia, MCP, pliki ignorowania, subagentów i skille, a lista wspieranych narzędzi liczy dziesiątki pozycji, w tym Claude Code i Codex CLI. Instaluje się przez npm install -g rulesync. Pracę zaczyna się od rulesync import --targets claudecode, które wciąga istniejący CLAUDE.md do folderu .rulesync/, a potem rulesync generate rozsyła wszystko dalej.

Ruler działa na poziomie projektu. Zasady piszesz w plikach Markdown w folderze .ruler/, ustawienia i serwery MCP w ruler.toml, a ruler apply zapisuje je do agentów. Codex dostaje AGENTS.md, ustawienia MCP w .codex/config.toml i skille w .agents/skills/. Obsługę skilli autor oznacza jako eksperymentalną. Ruler wymaga Node.js w wersji 20.19 lub nowszej.

agentsync jest zbudowany wokół globalnych ustawień, a nie jednego projektu. Masz jeden AGENTS.md, folder skills/ i plik mcp.json, a program podpina je do dwudziestu kilku obsługiwanych narzędzi, o ile znajdzie je na komputerze. Zamiast kopii robi linki, więc zmiana w jednym miejscu jest od razu widoczna wszędzie. Ma podgląd bez zapisu (--check), tryb obserwowania zmian (--watch) i cofanie do kopii zapasowej (--rollback latest). Na Windows linki do folderów wymagają trybu dewelopera, jeśli system nie pozwoli na zwykłe dowiązanie. Autor ostrzega też przed wrzucaniem mcp.json do wspólnego repozytorium, bo bywają w nim tokeny.

agent-rules-sync idzie dalej. Instalujesz go przez pip install agent-rules-sync i działa jako usługa systemowa: zmieniasz regułę w dowolnym narzędziu, a on rozsyła ją do pozostałych. Zasady i skille synchronizuje w obie strony, ustawienia z globalnej konfiguracji Claude’a przenosi do wybranych repozytoriów, a listy serwerów MCP scala.

Codex sam robi połowę roboty

Zanim zainstalujesz cokolwiek z tej listy, sprawdź, czego potrzebujesz naprawdę. Codex ma dwie wbudowane opcje, które u mnie załatwiły większość problemu. Pierwsza to project_doc_fallback_filenames = ["CLAUDE.md"] w ~/.codex/config.toml: Codex czyta wtedy CLAUDE.md wszędzie tam, gdzie nie ma AGENTS.md, więc zasady projektów są wspólne bez kopiowania. Druga to format skilli: folder z plikiem SKILL.md działa w obu narzędziach, różni się tylko miejsce, z którego go czytają.

Zostały mi globalne zasady i skille. Globalny AGENTS.md napisałem raz, a w nim wskazałem Codexowi folder pamięci Claude’a jako bazę wiedzy, więc notatki o projektach też są wspólne. Na skille wystarczył skrypt, który kopiuje je z ~/.claude/skills do ~/.agents/skills i nie rusza tych założonych w Codexie ręcznie. Udostępniam go razem z opisem całej procedury w tekście Jak przenieść Claude Code do Codexa.

Mam sześć własnych skilli, jedną osobę przy klawiaturze i dwa narzędzia. Program z usługą działającą w tle rozwiązywałby problem, którego nie mam, a dokładałby nowe miejsce, w którym coś może się zepsuć. Z oficjalnym importerem Codexa miałem zresztą właśnie taką przygodę: wyłożył się na polskich znakach w pierwszym pliku.

Kiedy brać gotowe narzędzie

Rachunek zmienia się w trzech sytuacjach:

• Zespół na różnych narzędziach. Jedna osoba pracuje w Cursorze, druga w Claude Code, trzecia w Codexie, a zasady projektu mają być wszędzie te same. Wtedy rulesync albo Ruler w repozytorium robią porządek, którego ręcznie nikt nie utrzyma.
• Więcej niż trzy narzędzia na jednym komputerze. Przy Claude Code, Codexie, Gemini CLI i Cursorze naraz linki z agentsync oszczędzają sporo pracy.
• Częste zmiany serwerów MCP. Każde narzędzie zapisuje je w innym formacie. Codex w TOML, Claude w JSON. Ręczne przepisywanie szybko się mści.

Przy dwóch narzędziach i jednej osobie zacząłbym od wbudowanych opcji Codexa. Jeśli zaczniesz łączyć Claude Code z Codexem także w drugą stronę, przyda się tekst o oficjalnej wtyczce Codex do Claude Code. Gotowe narzędzie warto dołożyć wtedy, gdy zacznie cię męczyć ręczne pilnowanie dwóch miejsc. U mnie po zmianie skilla wystarcza jedno polecenie: python synchronizuj-skille.py.

Czytasz Promptowego częściej? Dodaj go do preferowanych źródeł w Google, a nowe teksty będą wyżej w Twoich wynikach.

Źródła

• rulesync: https://github.com/dyoshikawa/rulesync
• Ruler: https://github.com/intellectronica/ruler
• agentsync: https://github.com/x0c/agentsync
• agent-rules-sync: https://github.com/dhruv-anand-aintech/agent-rules-sync
• OpenAI, Custom instructions with AGENTS.md: https://learn.chatgpt.com/docs/agent-configuration/agents-md
• OpenAI, Agent Skills: https://learn.chatgpt.com/docs/build-skills