Codex CLI może czytać i edytować pliki Markdown w wybranym katalogu, a także uruchamiać lokalne polecenia. To wystarcza, by sprawdzać linki, przygotowywać indeksy i proponować porządki w Vaultcie. Nie tworzy jednak samo z siebie wyszukiwarki RAG ani firmowego procesu zatwierdzania zmian. Te elementy trzeba zaprojektować osobno.
Najpraktyczniej traktować Codex jak narzędzie do pracy na kopii lub gałęzi roboczej. Niech najpierw wykryje problem i przygotuje zmianę. Człowiek powinien obejrzeć różnicę, sprawdzić źródła i zdecydować, co trafi do kanonicznych notatek.
Co Codex CLI może zrobić z Vaultem
Codex CLI działa w terminalu. Otwarty w katalogu Vaulta może analizować pliki, przygotować ich zmiany i uruchamiać dostępne lokalnie skrypty. Zakres zależy od trybu sandboxa i ustawień zgód. W konfiguracji workspace-write Codex może modyfikować pliki w bieżącym workspace; sieć jest domyślnie wyłączona. Próba wyjścia poza workspace albo użycia sieci może wymagać zgody. To techniczne ograniczenia środowiska, a nie redakcyjna akceptacja każdej zmiany.2
Poniższe scenariusze są przykładami hipotetycznymi, a nie opisem wdrożenia u klienta ani wyników MAWIL.
1. Lista przestarzałych notatek
Jeśli notatki mają pole reviewed_at albo review_date, lokalny skrypt może znaleźć dokumenty, których termin przeglądu minął. Codex może następnie podsumować, czego dotyczą, i przygotować kolejkę do sprawdzenia. Sam wiek notatki nie dowodzi, że jej treść jest błędna — wskazuje tylko, że warto ją ponownie zweryfikować.
Bez dat w metadanych agent może wyszukiwać konkretne sygnały, na przykład dawne nazwy produktów, wersje API albo nieaktualne adresy. Taki raport powinien pokazywać plik i fragment wymagający sprawdzenia. Aktualizacji faktu nie należy wykonywać bez potwierdzenia w bieżącym źródle.
2. Raport o niedziałających linkach
Skrypt może przeanalizować linki wewnętrzne Obsidiana i wypisać odwołania, których celu nie udało się znaleźć. Nie wystarczy jednak porównać samych nazw plików: linki mogą zawierać ścieżki, aliasy, odwołania do nagłówków i bloków. Codex może pogrupować wyniki i wskazać możliwe odpowiedniki. Jeśli cel jest niejednoznaczny, powinien to zgłosić, zamiast samodzielnie zmieniać link.
Podobny przegląd można zastosować do linków internetowych, ale ich stan zmienia się niezależnie od Vaulta. Sprawdzenie adresu potwierdza dostępność strony w chwili testu, nie to, że jej treść nadal wspiera cytowane twierdzenie.
Przykład: pierwszy audyt bez zmieniania notatek
Jeśli chcesz zacząć od zadania o małym ryzyku, uruchom Codex w kopii Vaulta, najlepiej w trybie read-only, i przekaż mu takie polecenie:
Przeanalizuj pliki Markdown w katalogu
docs/. Znajdź linki wewnętrzne Obsidiana, których cel może nie istnieć. Uwzględnij ścieżki, aliasy oraz odwołania do nagłówków i bloków. Dla każdego problemu podaj plik źródłowy, link i powód zgłoszenia. Jeśli nie masz pewności, oznacz wynik jako „do sprawdzenia”. Nie modyfikuj plików. Przedstaw raport w odpowiedzi.
Wynik przejrzyj ręcznie, szczególnie przy notatkach o takich samych nazwach w różnych folderach. Dopiero po sprawdzeniu raportu warto zlecić przygotowanie poprawek i porównać je przez git diff.
3. Proponowany indeks wiedzy
Na podstawie nazw i nagłówków plików Codex może przygotować projekt indeksu z tematami, linkami i krótkimi opisami. Najbezpieczniej zapisać go jako nowy plik roboczy. Właściciel wiedzy porównuje propozycję z istniejącą mapą, usuwa duplikaty i dopiero potem zatwierdza aktualizację kanonicznego indeksu.
4. Zmiana Markdown widoczna w Git
Pracę można rozpocząć od osobnej gałęzi albo kopii Vaulta. Codex poprawia tam wskazane pliki, a git diff pokazuje każdą zmianę względem wersji wyjściowej. Przeglądający sprawdza treść, linki i zakres zmian, po czym sam decyduje o scaleniu.
Git zapewnia historię i możliwość odtworzenia zmian. Sam diff nie potwierdza poprawności faktów i nie zastępuje akceptacji osoby odpowiedzialnej za dokument.
Granice dostępu i akceptacji
Tryb read-only nadaje się do audytu i planowania bez zapisu. Tryb workspace-write pozwala pracować w kopii lub kontrolowanej gałęzi; przy on-request komendy dozwolone przez sandbox mogą działać bez osobnego pytania. Nie należy więc traktować ustawienia zgód Codex jako akceptacji merytorycznej poszczególnych zmian.2
Praktyczna polityka dla firmowego Vaulta może wyglądać tak:
| Rodzaj działania | Przebieg |
|---|---|
| Czytanie i raportowanie | Dozwolone po ograniczeniu zakresu do wskazanych folderów. |
| Tworzenie projektu indeksu lub raportu | Zapis do kopii/gałęzi roboczej, potem przegląd człowieka. |
| Edycja istniejącej notatki | Diff, sprawdzenie źródeł i akceptacja właściciela notatki przed scaleniem. |
| Usuwanie, przenoszenie, zmiana zasad albo dostępu | Wymaga osobnej, jawnej zgody; automatyzacja nie powinna rozstrzygać tych decyzji. |
| Wysyłanie danych do zewnętrznego serwisu lub publikacja | Osobna kontrola celu, danych i odbiorcy. Nie wynika z samego dostępu do lokalnych plików. |
To polityka operacyjna, którą zespół musi przyjąć i egzekwować. Sam Codex CLI nie zna właściciela każdej notatki ani konsekwencji biznesowych jej zmiany.
Codex CLI, RAG i odpowiedzi ze źródłami
Codex CLI nie zapewnia automatycznie firmowej wyszukiwarki RAG. RAG to osobna architektura: wyszukuje odpowiednie fragmenty dokumentów, przekazuje je modelowi jako kontekst i powinna zachować odniesienia do tych fragmentów. To, czy odpowiedź rzeczywiście wynika ze źródła, nadal wymaga weryfikacji.8
Można poprosić Codex o wyszukanie tekstu w plikach albo uruchomić zewnętrzny retriever. To nie czyni RAG wbudowaną funkcją CLI. W MAWIL Content Intelligence repozytorium zawiera osobny etap knowledge, który — po skonfigurowaniu lokalizacji Vaulta — wyszukuje pasujące notatki i przekazuje ich fragmenty do procesu tworzenia treści. Jest to funkcja tego pipeline’u, a nie automatyczna właściwość Codex CLI.
Obsidian Sync, współpraca i szyfrowanie
Oficjalny Obsidian Sync obsługuje współdzielony Vault dla maksymalnie 20 współpracowników. Współpracownicy muszą mieć aktywną subskrypcję Sync, a uprawnienia nie są granularne: otrzymują takie same prawa do Vaulta jak jego właściciel; tylko właściciel może zapraszać kolejne osoby. Limit dotyczy współpracowników jednego współdzielonego Vaulta.3
Przy tworzeniu zdalnego Vaulta szyfrowanie end-to-end jest ustawieniem domyślnym, ale dostępne jest także szyfrowanie standardowe z kluczem zarządzanym przez Obsidian. Wybór dotyczy zdalnej kopii; Obsidian Sync nie szyfruje lokalnych plików Vaulta. Przy E2EE trzeba bezpiecznie przechować hasło — Obsidian nie może odzyskać utraconego klucza.4
Oficjalny Sync przechowuje zdalny Vault na serwerach usługi i nie oferuje rozwiązania on-premises. Obsidian udostępnia też headless klienta do synchronizacji w automatyzacji; dokumentacja oznacza go jako open beta i nadal wymaga subskrypcji Sync. Git, NAS lub wtyczki społecznościowe to odrębne sposoby synchronizacji, z własną konfiguracją, kontrolą dostępu i odpowiedzialnością za utrzymanie.56
Bezpieczeństwo modelu i dane przekazywane do niego
Sandbox i zgody ograniczają działania wykonywane przez Codex. Nie sprawiają, że treść znalezionego pliku staje się zaufana. Notatka może zawierać nieaktualne instrukcje, błędny fakt albo złośliwy tekst skierowany do modelu. Dlatego wynik polecenia i proponowany diff trzeba sprawdzić, a dostęp zawęzić do plików potrzebnych do zadania.
OWASP w wersji Top 10 z 2025 r. wymienia m.in. Prompt Injection, Sensitive Information Disclosure, Excessive Agency i Overreliance. To kategorie ryzyka aplikacji opartych na LLM, a nie stwierdzenie, że każde z tych zagrożeń ma formalny poziom „krytyczny”. Sama obecność RAG nie usuwa prompt injection.7
Lokalna praca CLI nie oznacza, że treść Vaulta nigdy nie trafia do modelu. Fragmenty użyte jako kontekst do odpowiedzi są przekazywane do usługi modelu. OpenAI deklaruje, że danych z API oraz produktów biznesowych nie wykorzystuje domyślnie do trenowania modeli. API może jednak tworzyć logi monitorowania nadużyć; domyślnie mogą one przechowywać treść do 30 dni, a Zero Data Retention wymaga kwalifikacji i zatwierdzenia. Zasady zależą od produktu i metody logowania do Codex, dlatego przed pracą z poufnymi notatkami trzeba sprawdzić warunki właściwe dla używanego konta.910
Jak ten podział wygląda w MAWIL
W MAWIL rozwijamy Knowledge Managera jako narzędzie do porządkowania firmowej wiedzy. Jego opis projektowy obejmuje pobieranie i indeksowanie źródeł, wyszukiwanie duplikatów i niedziałających linków, przeszukiwanie Vaulta oraz przygotowywanie raportów. Nie zakładamy, że agent sam zatwierdza zmiany, usuwa dokumenty czy je publikuje — te decyzje pozostają po stronie człowieka.11
Mamy też konkretny element działający w kodzie: etap knowledge w MAWIL Content Intelligence wyszukuje fragmenty notatek z lokalnego Vaulta, jeśli wskażemy jego lokalizację, i przekazuje je do dalszej pracy nad treścią. To funkcja tego pipeline’u. Nie oznacza, że cały plan Knowledge Managera został wdrożony ani że Codex CLI ma produkcyjny dostęp do wszystkich firmowych notatek.
Podział ról jest prosty: Vault jest źródłem wiedzy, narzędzia AI pomagają ją przeszukiwać i przygotowywać propozycje zmian, a właściciel dokumentacji decyduje, co zostaje przyjęte. Dzięki temu automatyzujemy powtarzalną pracę, nie oddając agentowi odpowiedzialności za firmowe informacje.
Od czego zacząć
Na początek wybierz jedno zadanie, którego wynik da się łatwo sprawdzić — na przykład raport o uszkodzonych linkach. Pracuj na kopii Vaulta, nie pozwalaj agentowi samodzielnie nadpisywać notatek i oceń raport przed zleceniem zmian. Dopiero gdy taki proces jest powtarzalny, dodawaj kolejne automatyzacje.
Chcesz połączyć AI z dokumentacją lub zautomatyzować powtarzalne procesy w swojej firmie? Sprawdź, jak możemy Ci w tym pomóc.
Źródła
- Codex CLI — dokumentacja i pierwsze kroki
- Codex — sandbox, approvals i kontrola sieci
- Obsidian — współdzielony Vault i ograniczenia współpracy
- Obsidian — szyfrowanie i prywatność Sync
- Obsidian — Sync dla zespołów, limity i on-premises
- Obsidian — headless klient Sync
- OWASP Top 10 for Large Language Model Applications
- Lewis i in., Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks
- OpenAI — prywatność danych biznesowych
- OpenAI API — data controls i retencja
- MAWIL, Knowledge Manager — README, Workflow oraz decyzja Knowledge Manager Agent (wewnętrzne dokumenty Vaulta; nie są publicznymi źródłami).
