Pierwsze kroki z Arc OS

Arc OS — system orkiestracji AI dla zespołów deweloperskich. Ten przewodnik wyjaśnia, czym jest Arc OS, dlaczego istnieje i jak zacząć efektywnie z niego korzystać.

Czym jest Arc OS?

Arc OS to platforma, która pozwala zbudować i zarządzać osobistym zespołem deweloperskim AI opartym na Claude.

Główna idea: zamiast otwierać nowy czat AI za każdym razem, gdy potrzebujesz pomocy, masz trwałych workerów AI, którzy:

• Znają Twój kod, architekturę i historię
• Nigdy nie tracą kontekstu między sesjami
• Każdy specjalizuje się w konkretnej roli
• Współdzielą tę samą bazę wiedzy projektu

Budujesz swój zespół raz. Potem z nim pracujesz — przez CLI, IDE lub web.

Główna idea: jeden LLM, wspólny kontekst, wyspecjalizowane role

Większość deweloperów używa AI jako jednorazowego czatu — wklej kod, dostań odpowiedź, zapomnij.

Arc OS działa inaczej:

Jeden LLM (Claude) — wszyscy workerzy działają na Claude. Wybraliśmy Claude ze względu na długie okno kontekstu, wykonywanie instrukcji i jakość kodu. Korzystasz z własnej subskrypcji Claude.

Brak utraty kontekstu — każdy worker ma dostęp do:

• Wiki Twojego projektu (decyzje architektoniczne, konwencje, notatki)
• Twoich skilli (niestandardowe instrukcje do konkretnych zadań)
• Twojego trackera zgłoszeń (nad czym trwają prace, co jest zrobione)
• Historii sesji (co było omawiane wcześniej)

Wyspecjalizowane role — każdy worker ma inną osobowość, uprawnienia i przeznaczenie:

Możesz też tworzyć niestandardowych workerów pod swoje konkretne potrzeby.

Czym jest projekt?

Projekt w Arc OS odpowiada jednemu codebase'owi lub produktowi, nad którym pracujesz.

Każdy projekt ma:

• Własny zestaw workerów (Developer, Consultant itd.)
• Własne wiki (dokumenty architektoniczne, decyzje, konwencje)
• Własne skille (niestandardowe instrukcje wstrzykiwane workerom)
• Własny tracker zgłoszeń (zadania, bugi, funkcje)
• Własną historię sesji

Możesz mieć wiele projektów — po jednym na produkt, klienta lub repozytorium.

Podstawowy sposób pracy: CLI Bridge

CLI bridge to główny interfejs Arc OS. Łączy Twój lokalny terminal lub IDE bezpośrednio z workerami AI.

# Start a Developer session on project "my-app"
arc my-app developer

# Start a Consultant (read-only) session
arc my-app consultant

# Continue the previous session (restores context)
arc my-app developer continue

Gdy uruchamiasz arc <project> <worker>, worker:

1. Ładuje wiki projektu, skille i aktywne zgłoszenie
2. Otwiera interaktywną sesję Claude w Twoim terminalu
3. Ma pełny dostęp do Twojego lokalnego systemu plików (Developer) lub tylko do odczytu (Consultant)
4. Zapisuje kontekst sesji na następny raz

Dlaczego CLI-first?

• Działa w każdym terminalu (macOS, Linux, Windows)
• Integruje się z VS Code, Cursor, JetBrains przez panel terminala
• Brak przełączania kontekstu — zostajesz w swoim edytorze
• Świadomy gita: worker widzi Twój bieżący branch, zmiany w stage'u, ostatnie commity

Kluczowe komendy arc CLI

arc <project> <worker>               # Start a session
arc <project> <worker> continue      # Resume previous session
arc sessions <project>               # Browse past sessions
arc issues                           # List open issues
arc issue create --title "..."       # Create new issue
arc issue log <id> "progress note"   # Log progress
arc skill <name>                     # Load a skill into context
arc wiki                             # Browse project wiki
arc roadmap                          # View project roadmap
arc retro <project>                  # Reconstruct issues from history

Jak zacząć

Krok 1 — Zainstaluj arc CLI

Pobierz binarkę dla swojego systemu z pulpitu Arc OS (Settings → CLI).

# macOS / Linux
chmod +x arc-linux-x64
sudo mv arc-linux-x64 /usr/local/bin/arc
arc --version

Krok 2 — Stwórz swój pierwszy projekt

W pulpicie CRM:

1. Kliknij New Project
2. Nadaj mu nazwę i połącz swoje repozytorium GitHub
3. System automatycznie tworzy Twój zespół workerów

Krok 3 — Dodaj skille (opcjonalnie, ale zalecane)

Skille to niestandardowe zestawy instrukcji, dzięki którym workerzy lepiej rozumieją Twój projekt:

• Konwencje stylu kodu
• Wzorce architektoniczne, których używasz
• Biblioteki i frameworki w Twoim stacku
• Rzeczy, które worker powinien zawsze / nigdy robić

Przejdź do Skill Registry → Generate — system czyta Twój codebase i automatycznie proponuje skille.

Krok 4 — Rozpocznij pierwszą sesję

arc my-project developer

Worker Developer przedstawi się, załaduje kontekst projektu i poczeka na Twoje pierwsze zadanie.

Krok 5 — Połącz Telegram (opcjonalnie)

Jeśli chcesz wysyłać szybkie wiadomości do workerów z telefonu lub będąc z dala od komputera, połącz Telegram przez Settings → Telegram Bot.

Telegram jest opcjonalny — cała podstawowa funkcjonalność działa przez CLI.

Jak workerzy współdzielą wiedzę

Wszyscy workerzy w tym samym projekcie współdzielą:

Wiki — dokumenty markdown o projekcie, pisane przez Ciebie lub workerów. Decyzje architektoniczne, konwencje API, „rzeczy, które warto wiedzieć", notatki onboardingowe. Workerzy automatycznie czytają wiki na początku sesji.

Skille — wielokrotnego użytku zestawy instrukcji. Skill „TypeScript strict mode" lub „zawsze najpierw pisz testy" jest wstrzykiwany do każdej odpowiedniej sesji workera.

Zgłoszenia — gdy worker pracuje nad zgłoszeniem #42, zna ten kontekst. Inni workerzy widzą, nad czym trwają prace.

Historia sesji — workerzy mogą odwoływać się do tego, co było omawiane w poprzednich sesjach przez arc sessions lub continue.

Standard Cloud — workspace zawsze online

Standard Cloud jest już dostępny. Z subskrypcją Standard Cloud otrzymujesz dedykowany kontener Docker na serwerach Arc OS (Hetzner).

Co to Ci daje

Trwałe pliki projektu na VPS Twój katalog /workspace żyje na serwerze — nie na laptopie. Pliki czekają na Ciebie, gdy wrócisz, nawet po zamknięciu komputera.

/workspace/my-project/   ← your code, always available
/home/arcuser/.claude/   ← Claude auth, persisted
/home/arcuser/.ssh/      ← GitHub SSH key, persisted

Synchronizacja z GitHub przez SSH Kontener ma dedykowany klucz SSH połączony z Twoim kontem GitHub. Robisz git clone raz — potem git pull / push skądkolwiek bez ponownego uwierzytelniania.

# Inside your container workspace
cd /workspace
git clone [email protected]:you/project.git   # once
git pull                                    # any time, from any device

Dostęp z dowolnego urządzenia Otwórz Arc OS CRM z telefonu, tabletu lub innego komputera — Twój workspace i pliki są dokładnie tam, gdzie je zostawiłeś. Koniec z problemem „zostawiłem projekt na drugiej maszynie".

Kontynuuj od miejsca, w którym skończyłeś

# In Telegram, next morning:
/continue

# Worker responds:
# Yesterday: finished auth middleware, tests remaining
# Continuing...

Worker podejmuje kontekst poprzedniej sesji i kontynuuje pracę — podczas gdy Ty pijesz kawę.

Co jest w zestawie

Jak aktywować

1. Przejdź do Billing → Standard Cloud
2. Wykup subskrypcję (aktualny cennik w pulpicie)
3. Kliknij Create Cloud Workspace — kontener jest gotowy w mniej niż 60 sekund
4. Połącz Claude Code (Twoja subskrypcja Claude Pro)
5. Połącz klucz SSH GitHub
6. Sklonuj swój projekt do /workspace

Twoja subskrypcja Claude Pro/Max jest osobna — korzystasz z własnej. Arc OS nie pobiera opłat za użycie Claude.

Czym Arc OS NIE jest

• Nie jest autonomicznym agentem — workerzy nie działają w tle bez Ciebie. Każda sesja zaczyna się, gdy ją otworzysz.
• Nie jest botem obsługi klienta — workerzy rozmawiają z Tobą (deweloperem), nie z Twoimi użytkownikami końcowymi.
• Nie jest narzędziem do automatyzacji workflow — Arc OS nie łączy się samodzielnie z zewnętrznymi API. Workerzy pomagają Ci pisać kod, który to robi.
• Nie jest zamiennikiem Claude.ai — Arc OS jest zbudowany na Claude, z dodanym kontekstem projektu i strukturą zespołu.

Najczęstsze pierwsze pytania

P: Czy potrzebuję Telegrama? Nie. Telegram jest opcjonalny. CLI bridge to podstawowy interfejs.

P: Czy workerzy współdzielą ze sobą kontekst? Tak — przez wspólne wiki, skille i tracker zgłoszeń. Nie współdzielą stanu sesji na żywo, ale czytają tę samą bazę wiedzy.

P: Czy mogę dostosowywać workerów? Tak. Worker Studio (w CRM) pozwala edytować system prompt, skille i zachowanie każdego workera.

P: Jak działają rozliczenia? Korzystasz z własnej subskrypcji Claude Pro lub Max. Arc OS nie dolicza opłat za użycie Claude — płacisz bezpośrednio Anthropic. Arc OS pobiera opłatę platformową za pulpit i narzędzia.

P: A jeśli chcę typ workera, którego nie ma na liście? Stwórz niestandardowego workera w Worker Studio. Zdefiniuj jego rolę, uprawnienia i wstrzyknij dowolne skille, których potrzebujesz.

Twoje dane i prywatność

Arc OS jest zaprojektowany tak, aby Twoje dane pozostawały pod Twoją kontrolą.

Eksport danych (RODO art. 20)

W każdej chwili możesz pobrać pełny eksport JSON wszystkich danych swojego konta:

1. Przejdź do Settings → Security → Download my data
2. Plik JSON jest generowany i pobierany natychmiast

Eksport obejmuje informacje o koncie, projekty, historię czatów, zgłoszenia, strony wiki, skille i logi aktywności. Limit: 3 eksporty na 24 godziny.

Usunięcie konta (RODO art. 17)

W każdej chwili możesz trwale usunąć swoje konto:

1. Przejdź do Settings → Security → Delete account
2. Potwierdź usunięcie

To natychmiast i trwale usuwa wszystkie Twoje dane ze wszystkich tabel — projekty, historię czatów, skille, wpisy vaulta, logi aktywności i rekord Twojego konta. Ta operacja jest nieodwracalna.

Czego nie robimy

• Nie używamy Twojego kodu, promptów ani odpowiedzi AI do trenowania modeli
• Nie osadzamy trackerów reklamowych ani SDK analitycznych
• Nie ustawiamy cookies HTTP — cały stan sesji jest w localStorage
• Nie udostępniamy Twoich danych stronom trzecim poza tym, co niezbędne do działania usługi (CDN Cloudflare, inferencja AI Anthropic, dostawcy OAuth)

Pełna polityka: Polityka prywatności.