Dokumentacja Arc OS
System orkiestracji dla zespołów AI. 70+ endpointów API. Pulpit CRM. Własne wyszukiwanie semantyczne (Cohere + sqlite-vec, Phase 71). Zbudowany na Claude Code.
ℹ️ Phase 71 (2026-06-05): Wyszukiwanie semantyczne działa teraz na własnym pipeline RAG (
shared/rag.ts+ Cohereembed-multilingual-v3.0+sqlite-vec). Bridge NotebookLM z Phase 36 został wycofany. Wzmianki o NotebookLM poniżej dotyczą starego setupu; aktualna architektura: RAG Architecture (po angielsku — tłumaczenie wkrótce).
Szybka nawigacja
| Chcę... | Przejdź do |
|---|---|
| Zobaczyć, co robi Arc OS w 5 slajdach | Główne funkcje — 5 filarów + przycisk obejrzenia wycieczki |
| Nauczyć się korzystać z pulpitu CRM | Przewodnik użytkownika |
| Połączyć swój lokalny komputer z workerami CRM | Local Bridge CLI — zero zależności, pobierz i uruchom |
| Używać ARC CLI do zadań, wiki i roadmapy | Dokumentacja ARC CLI — wszystkie komendy z przykładami |
| Skonfigurować boty Telegram | Przewodnik po botach Telegram — Master Bot, Child Bot, routing workerów |
| Używać wyszukiwania semantycznego (NotebookLM) | NotebookLM Bridge — synchronizacja, wyszukiwanie, poziomy pamięci |
| Zrozumieć Workerów i Warstwę Inteligencji | Workerzy i Inteligencja — Evals, Context Router, Learnings |
| Przeglądać dokumentację API | Dokumentacja API — 70+ endpointów z parametrami |
| Zobacz schemat bazy danych | Schemat bazy danych — 21+ tabel, 21 migracji, diagram ER |
| Skonfigurować lokalne środowisko dev | Konfiguracja developerska — Bun, Node, porty, zmienne env |
| Zdiagnozować problem | Rozwiązywanie problemów — auth, workerzy, bridge, błędy frontendu |
| Zrozumieć, czym jest Arc OS | Przegląd produktu |
| Zobaczyć, jakie problemy rozwiązuje | Problemy i rozwiązania |
| Porównać z innymi narzędziami | Analiza konkurencji |
| Dowiedzieć się, jak działa Warstwa Inteligencji | 4 Filary |
| Zobaczyć specyfikacje systemu (snapshot Phase 21.5) | Raport systemu |
| Stworzyć nowy skill | Tworzenie skilli |
| Uruchomić wiele projektów bez mieszania kontekstu | Izolacja skilli multi-projekt |
Według sekcji
Produkt
Czym jest Arc OS, dla kogo i dlaczego istnieje.
- Przegląd — Kluczowe możliwości, podsumowanie architektury, kluczowe liczby
- Problemy i rozwiązania — 5 prawdziwych problemów deweloperów z narzędziami AI i jak Arc OS rozwiązuje każdy z nich
- Analiza konkurencji — Macierz funkcji vs ChatGPT, Cursor, Windsurf, Devin. Porównanie przypadków użycia
Architektura
Jak system działa pod maską.
- Workerzy i Warstwa Inteligencji — 6 wbudowanych workerów, Binary Evals (6 typów reguł), Context Router, Learnings, Karpathy Loop (nocne samodoskonalenie)
- Schemat bazy danych — 21+ tabel, 21 migracji, klucze obce, diagram ER. Tryb WAL SQLite, indeksy, pragmy
- Warstwa Inteligencji — 4 Filary — Binary Evals, Context Router, Reflect Loop, Karpathy Loop. Plus Sage Worker i odkrywanie marketplace
- Raport systemu — Phase 21.5 — Historyczny snapshot: mapa modułów, inwentarz skilli, szczegóły infrastruktury (Phase 21.5)
Przewodniki
Instrukcje krok po kroku dotyczące korzystania i rozszerzania systemu.
- Przewodnik użytkownika — Kompletny przewodnik po pulpicie CRM: logowanie (OAuth, email, Telegram), workspace, workerzy, zgłoszenia, wiki, skille, menedżer plików, analityka i więcej
- Dokumentacja ARC CLI — Wszystkie komendy CLI: logowanie, zgłoszenia, skille, wiki, roadmapa, raport, pamięć, wrapup (egzekwowanie dokumentacji), github (linkowanie repo). Z przykładami i zmiennymi env
- Przewodnik po botach Telegram — Master Bot (orkiestracja) + Child Bot (proxy AI). Komendy, klawiatury inline, routing workerów, integracja CRM
- NotebookLM Bridge — Wyszukiwanie semantyczne przez Google AI. Auto-sync, cache zapytań, poziomy pamięci, pobieranie artefaktów
- Local Bridge CLI — Bridge bez zależności: pobierz, wklej token, gotowe. Samodzielne binaria dla Windows, macOS, Linux
- Local Bridge — macOS — Apple Silicon + Intel, przepływ Gatekeeper, install.command
- Local Bridge — Linux — x64 + arm64, ekstrakcja tar.gz, wskazówki ripgrep
- Local Bridge — Windows — Windows 10/11, SmartScreen, quirki antywirusowe
- Tworzenie skilli — Napisz skill.md, dodaj evals.json, zarejestruj w _registry.json, przetestuj potok
- Izolacja skilli multi-projekt — 3 poziomy izolacji: CLAUDE.md, skills/, Context Router. Evals per projekt, learnings, metryki
- Konfiguracja developerska — Lokalne środowisko dev: Bun, Node, porty, zmienne env, Docker, struktura projektu
- Rozwiązywanie problemów — Diagnozuj problemy z auth, workerami, bridge, frontendem i bazą danych według objawów
- Integracja GitHub — Powiadomienia przez webhook + feed w sidebarze dla powiązanych repo. HMAC-SHA256, multi-repo per projekt, alerty Telegram (Phase 49.3)
- Konfiguracja email — Podręcznik operacyjny dla
[email protected]: Cloudflare Email Routing (bezpłatne, 10 min), DMARC, ścieżka migracji do Zoho/Workspace
API
- Dokumentacja CRM API — 70+ endpointów w 13 kategoriach: auth, projekty, workerzy, pliki, skille, czat, wiki, analityka, marketplace, rozliczenia, zaproszenia, pamięć. Formaty żądań/odpowiedzi, kody błędów, bezpieczeństwo
Architektura (dogłębna)
Wewnętrzna architektura dla zaawansowanych użytkowników — komponenty, decyzje i dogłębne opisy per phase.
- Przegląd architektury — Mapa systemu najwyższego poziomu z diagramem mermaid, lista komponentów, przepływy danych
- Phase 20 — Federacja botów — Architektura Master + Dzieci, watchdog, vault
- Phase 45 — Zero-Knowledge E2EE — Wyprowadzanie kluczy PBKDF2, AES-256-GCM, klucze odykiwania, cache sessionStorage
- Przepływ dwóch agentów — Podział Consultant + Developer, kolejka spec, przepływ zatwierdzania
- Ewoluująca inteligencja — Pętla Karpathy'ego, wstrzykiwanie learnings, nocne doskonalenie
- Backend CRM — Internals serwera HTTP Bun, dispatch tras, prymitywy SSE/WebSocket
Bezpieczeństwo
- Przegląd bezpieczeństwa — Model zagrożeń, podsumowanie hartowania, testy dymne po deployu
- Audyt bezpieczeństwa 2026-04-23 — Wieloprzebiegowy przegląd Sentinel, 13 łatek, werdykt ZIELONY
Status projektu
- Roadmapa — Harmonogram phase (mermaid) + ukończone/w toku/planowane dla wszystkich 52 faz
- Przegląd produktu — Kompletna lista funkcji (27 funkcji), redukcja v1→v2, dla kogo jest
Według mechanizmu
Znajdź dokumentację dla konkretnej funkcji Arc OS.
| Mechanizm | Co robi | Dokumentacja |
|---|---|---|
| Binary Evals | Deklaratywne reguły walidujące każdą odpowiedź AI | Warstwa Inteligencji, Tworzenie skilli |
| Context Router | Ocenia skille per wiadomość, wstrzykuje top-5 jako wskazówki | Warstwa Inteligencji, Raport systemu |
| Reflect Loop | Konwertuje Fix It / kciuk w dół w trwałe reguły | Warstwa Inteligencji |
| Karpathy Loop | Nocna analiza metryk, ulepszenia zatwierdzone przez CEO | Warstwa Inteligencji |
| Sage Worker | Analizator skilli zasilany AI, benchmarki, odkrywanie marketplace | Przewodnik użytkownika |
| System skilli | Przenośne zestawy instrukcji z evals i rejestrem | Tworzenie skilli, Multi-projekt |
| Izolacja projektów | Federowane child boty z niezależnym kontekstem | Multi-projekt, Przegląd |
| Śledzenie jakości | Wskaźnik sukcesu per skill, feedback, metryki czasu | Raport systemu, Problemy |
| Learnings | Trwała pamięć korekt per projekt | Warstwa Inteligencji, Multi-projekt |
| Rejestr skilli | Centralny indeks z triggerami, słowami kluczowymi, kategoriami | Tworzenie skilli, Multi-projekt |
| Dynamiczni workerzy | Rozszerzalny system workerów AI (typy chat + terminal) | Przewodnik użytkownika, Przewodnik użytkownika |
| Załączniki plików | Przesyłanie tekstu, obrazów i PDF do wiadomości workera | Przewodnik użytkownika |
| Menedżer plików | Przeglądarka plików po stronie serwera z CRUD + klonowanie git | Przewodnik użytkownika |
| Zgłoszenia | Tracker zgłoszeń projektu z dziennikiem aktywności | Przewodnik użytkownika |
| Wiki | Per-projektowa baza wiedzy ze stronami markdown | Przewodnik użytkownika |
| Graf wiedzy | Interaktywna wizualizacja relacji encji | Przewodnik użytkownika |
| Pulpit CRM | Web UI do zarządzania projektami i interakcji z AI | Przewodnik użytkownika |
| Local Bridge | Przekaźnik WebSocket dla lokalnego dostępu do plików z workerów CRM | Local Bridge CLI |
| Cloud PM | Trwały czat projektu z Claude | Przewodnik użytkownika |
| ARC CLI | Narzędzie wiersza poleceń do skilli, zgłoszeń, wiki, raportów | Dokumentacja ARC CLI, Przewodnik użytkownika |
| Boty Telegram | Master (orkiestracja) + Child (proxy AI per projekt) | Przewodnik po botach Telegram |
| NotebookLM Bridge | Wyszukiwanie semantyczne przez Google AI, auto-sync | NotebookLM Bridge, Warstwa Inteligencji |
| System workerów | 6 wbudowanych workerów ze scoped narzędziami i modelami | Workerzy i Inteligencja |
| CRM API | 70+ endpointów REST z auth JWT | Dokumentacja API |
| Bezpieczeństwo i szyfrowanie | Fundament E2EE, szyfrowanie at-rest, klucze odykiwania | Architektura bezpieczeństwa, Phase 45 E2EE |
| Integracja GitHub | Powiadomienia przez webhook + feed w sidebarze dla powiązanych repo | Konfiguracja integracji GitHub |
| Egzekwowanie dokumentacji | Pre-push hook + arc wrapup CLI do synchronizacji dokumentacji |
Dokumentacja ARC CLI |
| Baza danych | SQLite z WAL, 21+ tabel, 21 migracji | Schemat bazy danych |
| Rozwiązywanie problemów | Diagnozuj problemy według objawów | Rozwiązywanie problemów |
Status dokumentów
| Dokument | Wersja | Ostatnia aktualizacja |
|---|---|---|
| Przewodnik użytkownika | 2.0 | 2026-04-15 |
| Dokumentacja ARC CLI | 1.0 | 2026-04-27 |
| Przewodnik po botach Telegram | 1.0 | 2026-04-27 |
| NotebookLM Bridge | 1.0 | 2026-04-27 |
| Workerzy i Inteligencja | 1.0 | 2026-04-27 |
| Dokumentacja API | 1.0 | 2026-04-27 |
| Schemat bazy danych | 1.0 | 2026-04-27 |
| Konfiguracja developerska | 1.0 | 2026-04-27 |
| Rozwiązywanie problemów | 1.0 | 2026-04-27 |
| Przegląd produktu | 2.0 | 2026-04-15 |
| Problemy i rozwiązania | 1.0 | 2026-04-03 |
| Analiza konkurencji | 2.0 | 2026-04-15 |
| Warstwa Inteligencji | 2.0 | 2026-04-15 |
| Raport systemu 21.5 | 1.0 (historyczny) | 2026-04-03 |
| Tworzenie skilli | 1.0 | 2026-04-03 |
| Izolacja multi-projekt | 1.0 | 2026-04-03 |
| Local Bridge CLI | 2.0 | 2026-04-08 |