Початок роботи з Arc OS

Arc OS — система оркестрації AI для команд розробки. Цей гайд пояснює, що таке Arc OS, навіщо вона існує і як почати ефективно нею користуватись.

Що таке Arc OS?

Arc OS — це платформа, яка дозволяє побудувати і керувати персональною AI-командою розробки поверх Claude.

Основна ідея: замість відкривати новий AI-чат щоразу, коли потрібна допомога, ти маєш персистентних AI-воркерів, які:

Знають твою кодову базу, архітектуру та історію
Ніколи не втрачають контекст між сесіями
Кожен спеціалізується на своїй ролі
Поділяють спільну базу знань проєкту

Команду ти збираєш один раз. Далі просто працюєш із нею — через CLI, IDE чи веб.

Головна ідея: один LLM, спільний контекст, спеціалізовані ролі

Більшість розробників використовують AI як одноразовий чат — вставив код, отримав відповідь, забув.

Arc OS працює інакше:

Один LLM (Claude) — усі воркери працюють на Claude. Ми обрали Claude за довге контекстне вікно, дотримання інструкцій та якість коду. Ти приходиш зі своєю підпискою Claude.

Без втрати контексту — кожен воркер має доступ до:

Wiki твого проєкту (архітектурні рішення, конвенції, нотатки)
Твоїх навичок (кастомні інструкції для конкретних задач)
Твого трекера задач (що в роботі, що зроблено)
Історії сесій (що обговорювалося раніше)

Спеціалізовані ролі — кожен воркер має власний характер, права доступу та призначення:

Воркер	Роль	Що робить
Developer	Повний доступ	Пише код, виконує команди, комітить, дебажить
Consultant	Лише читання	Робить рев'ю, пояснює, радить — ніколи не торкається файлів
Designer	UI/UX-фокус	Дизайн компонентів, доступність, візуальні системи
Sentinel	Безпека	Аудитить код, шукає вразливості, зміцнює системи
Archivist	Документація	Пише доки, оновлює wiki, генерує звіти
Product Owner	Планування	Веде roadmap, створює задачі, пріоритезує беклог

Також можна створювати кастомних воркерів під свої потреби.

Що таке проєкт?

Проєкт в Arc OS відповідає одній кодовій базі чи продукту, над яким ти працюєш.

Кожен проєкт має:

Власний набір воркерів (Developer, Consultant тощо)
Власну wiki (архітектурні доки, рішення, конвенції)
Власні навички (кастомні інструкції, що інжектяться у воркерів)
Власний трекер задач (таски, баги, фічі)
Власну історію сесій

Проєктів може бути кілька — по одному на продукт, клієнта чи репозиторій.

Основний спосіб роботи: CLI Bridge

CLI bridge — головний інтерфейс Arc OS. Він напряму з'єднує твій локальний термінал чи IDE з 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

Коли ти запускаєш arc <project> <worker>, воркер:

Завантажує wiki проєкту, навички та активну задачу
Відкриває інтерактивну сесію Claude у твоєму терміналі
Має повний доступ до локальної файлової системи (Developer) або лише читання (Consultant)
Зберігає контекст сесії на наступний раз

Чому CLI-first?

Працює в будь-якому терміналі (macOS, Linux, Windows)
Інтегрується з VS Code, Cursor, JetBrains через панель терміналу
Без перемикання контексту — лишаєшся в редакторі
Git-aware: воркер бачить поточну гілку, staged-зміни, останні коміти

Ключові команди 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

Як почати

Крок 1 — Встанови arc CLI

Завантаж бінарник для своєї ОС із дашборду Arc OS (Settings → CLI).

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

Крок 2 — Створи свій перший проєкт

У CRM dashboard:

Натисни New Project
Дай йому назву і підключи свій GitHub-репозиторій
Система автоматично створить твою команду воркерів

Крок 3 — Додай навички (опціонально, але рекомендовано)

Навички — це кастомні набори інструкцій, які роблять воркерів розумнішими щодо твого проєкту:

Конвенції стилю коду
Архітектурні патерни, які ти використовуєш
Бібліотеки та фреймворки у твоєму стеку
Що воркер має завжди / ніколи не робити

Перейди у Skill Registry → Generate — система прочитає твою кодову базу і запропонує навички автоматично.

Крок 4 — Запусти першу сесію

arc my-project developer

Воркер Developer представиться, завантажить контекст твого проєкту і чекатиме на першу задачу.

Крок 5 — Підключи Telegram (опціонально)

Якщо хочеш надсилати воркерам швидкі повідомлення з телефона чи коли ти не за комп'ютером, підключи Telegram через Settings → Telegram Bot.

Telegram опціональний — уся основна функціональність працює через CLI.

Як воркери діляться знаннями

Усі воркери одного проєкту поділяють:

Wiki — markdown-документи, які пишеш ти або воркери, про проєкт. Архітектурні рішення, API-конвенції, "що варто знати", онбордингові нотатки. Воркери читають wiki автоматично на старті сесії.

Навички — багаторазові набори інструкцій. Навичка "TypeScript strict mode" чи "завжди спочатку тести" інжектиться в кожну релевантну сесію воркера.

Задачі — коли воркер працює над задачею #42, він знає цей контекст. Інші воркери бачать, що в роботі.

Історія сесій — воркери можуть звертатись до того, що обговорювалося в попередніх сесіях, через arc sessions або continue.

Standard Cloud — постійно доступний робочий простір

Standard Cloud уже доступний. З підпискою Standard Cloud ти отримуєш виділений Docker-контейнер на серверах Arc OS (Hetzner).

Що це дає

Персистентні файли проєкту на VPS Твоя директорія /workspace живе на сервері — не на ноутбуці. Файли на місці, коли ти повертаєшся, навіть після закриття комп'ютера.

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

Синхронізація з GitHub через SSH Контейнер має виділений SSH-ключ, підключений до твого GitHub-акаунта. Робиш git clone один раз — далі git pull / push звідки завгодно без повторної автентифікації.

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

Доступ із будь-якого пристрою Відкрий Arc OS CRM з телефона, планшета чи іншого комп'ютера — твій робочий простір і файли рівно там, де ти їх залишив. Жодної проблеми "проєкт залишився на іншій машині".

Продовжуй із того місця, де зупинився

# In Telegram, next morning:
/continue

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

Воркер підхоплює контекст попередньої сесії і продовжує працювати — поки ти п'єш каву.

Що входить

Можливість	Free / Local	Standard Cloud
arc CLI (локально)	✅	✅
CRM dashboard	✅	✅
Персистентний VPS workspace	❌	✅
GitHub SSH-інтеграція	❌	✅
Доступ із будь-якого пристрою	❌	✅
/continue із Telegram	❌	✅
Файли переживають закриття ноутбука	❌	✅

Як активувати

Перейди в Billing → Standard Cloud
Оформи підписку (актуальні ціни — у дашборді)
Натисни Create Cloud Workspace — контейнер готовий менш ніж за 60 секунд
Підключи Claude Code (твоя підписка Claude Pro)
Підключи GitHub SSH-ключ
Склонуй свій проєкт у /workspace

Твоя підписка Claude Pro/Max — окрема, ти приходиш зі своєю. Arc OS не бере плату за використання Claude.

Чим Arc OS НЕ є

Не автономний агент — воркери не працюють у фоні без тебе. Кожна сесія починається, коли ти її відкриваєш.
Не бот підтримки клієнтів — воркери спілкуються з тобою (розробником), а не з твоїми кінцевими користувачами.
Не інструмент автоматизації workflow — Arc OS сама не підключається до зовнішніх API. Воркери допомагають тобі написати код, який це робить.
Не заміна Claude.ai — Arc OS збудована поверх Claude, з доданим контекстом проєкту та структурою команди.

Поширені перші запитання

П: Чи потрібен Telegram? Ні. Telegram опціональний. Основний інтерфейс — CLI bridge.

П: Чи діляться воркери контекстом між собою? Так — через спільні wiki, навички та трекер задач. Вони не ділять живий стан сесії, але читають одну й ту саму базу знань.

П: Чи можна кастомізувати воркерів? Так. Worker Studio (у CRM) дозволяє редагувати системний промпт, навички та поведінку кожного воркера.

П: Як працює білінг? Ти використовуєш власну підписку Claude Pro або Max. Arc OS не додає плату за використання Claude — ти платиш Anthropic напряму. Arc OS бере платформенну плату за дашборд і тулінг.

П: А якщо мені потрібен тип воркера, якого немає в списку? Створи кастомного воркера у Worker Studio. Визнач його роль, права доступу та інжекти будь-які потрібні навички.

Твої дані та приватність

Arc OS спроєктована так, щоб твої дані залишалися під твоїм контролем.

Експорт даних (GDPR ст. 20)

Ти можеш будь-коли завантажити повний JSON-експорт усіх даних свого акаунта:

Перейди в Settings → Security → Download my data
JSON-файл генерується і завантажується одразу

Експорт містить дані акаунта, проєкти, історію чатів, задачі, сторінки wiki, навички та журнали активності. Обмеження — 3 експорти на 24 години.

Видалення акаунта (GDPR ст. 17)

Ти можеш будь-коли назавжди видалити свій акаунт:

Перейди в Settings → Security → Delete account
Підтверди видалення

Це негайно і безповоротно стирає всі твої дані в усіх таблицях — проєкти, історію чатів, навички, записи vault, журнали активності та сам запис акаунта. Дія незворотна.

Чого ми не робимо

Ми не використовуємо твій код, промпти чи AI-відповіді для тренування моделей
Ми не вбудовуємо рекламні трекери чи аналітичні SDK
Ми не ставимо HTTP-cookies — увесь стан сесії зберігається у localStorage
Ми не передаємо твої дані третім сторонам понад необхідне для роботи сервісу (Cloudflare CDN, AI-інференс Anthropic, OAuth-провайдери)

Повна політика — у Privacy Policy.