Документація Arc OS
Система оркестрації для AI-команд. 70+ API-ендпоінтів. CRM-дашборд. Семантичний пошук. Побудовано на Claude Code.
Швидка навігація
| Я хочу... | Перейти до |
|---|---|
| Побачити, що робить Arc OS, за 5 слайдів | Основні можливості — 5 стовпів + кнопка перегляду туру |
| Отримати швидкі відповіді (ціни, Cowork vs Arc OS, внутрішня будова) | FAQ — продукт, архітектура, безпека та дані |
| Навчитися користуватися CRM-дашбордом | Посібник користувача |
| Підключити мою локальну машину до CRM-воркерів | Local Bridge CLI — без залежностей, завантаж і запусти подвійним кліком |
| Використовувати ARC CLI для задач, вікі й роадмапу | Довідник ARC CLI — усі команди з прикладами |
| Налаштувати Telegram-ботів | Посібник з Telegram-ботів — Master Bot, Child Bot, маршрутизація воркерів |
| Використовувати семантичний пошук по вмісту проєкту | Архітектура RAG — ембединги Cohere + sqlite-vec, замінює NotebookLM з Phase 71 |
| Зрозуміти воркерів і Intelligence Layer | Воркери та Intelligence — Evals, Context Router, Learnings |
| Переглянути довідник API | Довідник API — 70+ ендпоінтів з параметрами |
| Побачити схему бази даних | Схема бази даних — 30+ таблиць, 35 міграцій, ER-діаграма |
| Налаштувати локальну розробку | Налаштування розробки — Bun, Node, порти, env-змінні |
| Діагностувати проблему | Усунення проблем — помилки auth, воркерів, Bridge, фронтенду |
| Зрозуміти, що таке Arc OS | Огляд продукту |
| Побачити, які проблеми це вирішує | Болі та рішення |
| Порівняти з іншими інструментами | Конкурентний аналіз |
| Дізнатися, як працює Intelligence Layer | 4 стовпи |
| Побачити ранній знімок системи (історичний) | Звіт про систему — архів Phase 21.5 |
| Створити новий скіл | Створення скілів |
| Запускати кілька проєктів без змішування контексту | Ізоляція скілів між проєктами |
За розділами
Продукт
Що таке Arc OS, для кого він і навіщо існує.
- Огляд — основні можливості, короткий опис архітектури, ключові цифри
- Болі та рішення — 5 реальних проблем, з якими розробники стикаються в AI-інструментах, і як Arc OS вирішує кожну з них
- Конкурентний аналіз — матриця можливостей проти ChatGPT, Cursor, Windsurf, Devin. Порівняння за сценаріями використання
Архітектура
Як система працює під капотом.
- Воркери та Intelligence Layer — 13 пресетів ролей воркерів, Binary Evals (6 типів правил), Context Router, Learnings, Karpathy Loop (нічне самовдосконалення)
- Схема бази даних — 30+ таблиць, 35 міграцій, зовнішні ключі, ER-діаграма. SQLite у режимі WAL, індекси, pragma
- Intelligence Layer — 4 стовпи — Binary Evals, Context Router, Reflect Loop, Karpathy Loop. Плюс Sage Worker і Marketplace Discovery
- Звіт про систему — Phase 21.5 (архів) — історичний знімок із раннього етапу розробки; збережений для довідки, заміщений сторінками архітектури вище
Посібники
Покрокові інструкції з використання та розширення системи.
- Посібник користувача — повний посібник з CRM-дашборду: вхід (OAuth, email, Telegram), робочий простір, воркери, задачі, вікі, скіли, файловий менеджер, аналітика та інше
- Довідник ARC CLI — усі команди CLI: login, issues, skills, wiki, roadmap, report, memory, wrapup (контроль документації), github (прив'язка репозиторіїв). З прикладами та env-змінними
- Посібник з Telegram-ботів — Master Bot (оркестрація) + Child Bot (AI-проксі). Команди, inline-клавіатури, маршрутизація воркерів, інтеграція з CRM
- Архітектура RAG — самохостингований семантичний пошук з Phase 71: Cohere embed-multilingual-v3.0 +
sqlite-vecусередині наявної SQLite SSOT. Замінює застарілий NotebookLM bridge (виведений з експлуатації 2026-06-05) - Local Bridge CLI — Bridge без залежностей: завантаж, встав токен, готово. Окремі бінарники для Windows, macOS, Linux
- Local Bridge — macOS — Apple Silicon + Intel, робочий процес Gatekeeper, install.command
- Local Bridge — Linux — x64 + arm64, розпакування tar.gz, поради щодо ripgrep
- Local Bridge — Windows — Windows 10/11, SmartScreen, особливості антивірусів
- Створення скілів — напиши skill.md, додай evals.json, зареєструй у _registry.json, протестуй конвеєр
- Ізоляція скілів між проєктами — 3 рівні ізоляції: CLAUDE.md, skills/, Context Router. Окремі evals, learnings, метрики для кожного проєкту
- Налаштування розробки — локальне середовище розробки: Bun, Node, порти, env-змінні, Docker, структура проєкту
- Усунення проблем — діагностика проблем auth, воркерів, Bridge, фронтенду та бази даних за симптомами
- Інтеграція з GitHub — сповіщення на основі вебхуків + стрічка в сайдбарі для прив'язаних репозиторіїв. HMAC-SHA256, кілька репозиторіїв на проєкт, сповіщення в Telegram (Phase 49.3)
- Налаштування Email — операційний ранбук для
[email protected]: Cloudflare Email Routing (безкоштовно, 10 хв), DMARC, шлях міграції на Zoho/Workspace
API
- Довідник CRM API — 70+ ендпоінтів у 13 категоріях: auth, проєкти, воркери, файли, скіли, чат, вікі, аналітика, marketplace, білінг, інвайти, пам'ять. Формати запитів/відповідей, коди помилок, безпека
Архітектура (поглиблено)
Внутрішня архітектура для досвідчених користувачів — компоненти, рішення та поглиблені огляди по фазах.
- Огляд архітектури — високорівнева мапа системи з mermaid-діаграмою, список компонентів, потоки даних
- Phase 20 — Федеративні боти — архітектура Master + Children, watchdog, vault, watchdog
- Phase 45 — Zero-Knowledge E2EE — деривація ключа PBKDF2, AES-256-GCM, ключі відновлення, кешування в sessionStorage
- Потік Dual-Agent — розподіл Consultant + Developer, черга специфікацій, потік затвердження
- Evolving Intelligence — Karpathy loop, інжекція learnings, нічне вдосконалення
- Бекенд CRM — внутрішня будова HTTP-сервера Bun, диспетчеризація маршрутів, примітиви SSE/WebSocket
Безпека
- Огляд безпеки — модель загроз, підсумок hardening, smoke-тести під час деплою
- Аудит безпеки 2026-04-23 — багатопрохідний огляд Sentinel, 13 патчів, вердикт GREEN
Статус проєкту
- Роадмап — таймлайн фаз (mermaid) + завершено/у процесі/заплановано для всіх 52 фаз
- Огляд продукту — повний список можливостей (27 фіч), скорочення v1→v2, для кого це
За механізмами
Знайди документацію для конкретної можливості Arc OS.
| Механізм | Що робить | Документація |
|---|---|---|
| Binary Evals | Декларативні правила, що валідують кожну AI-відповідь | Intelligence Layer, Створення скілів |
| Context Router | Оцінює скіли для кожного повідомлення, інжектує топ-5 як підказки | Intelligence Layer, Звіт про систему |
| Reflect Loop | Перетворює Fix It / thumbs-down на постійні правила | Intelligence Layer |
| Karpathy Loop | Нічний аналіз метрик, схвалені CEO покращення | Intelligence Layer |
| Sage Worker | AI-аналізатор скілів, бенчмарки, discovery в marketplace | Посібник користувача |
| Система скілів | Портативні набори інструкцій з evals і реєстром | Створення скілів, Multi-Project |
| Ізоляція проєктів | Федеративні child-боти з незалежним контекстом | Multi-Project, Огляд |
| Відстеження якості | Показник успішності, фідбек, метрики тривалості для кожного скілу | Звіт про систему, Болі |
| Learnings | Постійна пам'ять корекцій для кожного проєкту | Intelligence Layer, Multi-Project |
| Реєстр скілів | Центральний індекс із тригерами, ключовими словами, категоріями | Створення скілів, Multi-Project |
| Динамічні воркери | Розширювана система AI-воркерів (типи chat + terminal) | Посібник користувача, Посібник користувача |
| Вкладення файлів | Завантаження тексту, зображень і PDF до повідомлень воркера | Посібник користувача |
| Файловий менеджер | Серверний файловий браузер з CRUD + git clone | Посібник користувача |
| Задачі | Трекер задач проєкту з логом активності | Посібник користувача |
| Вікі | База знань проєкту зі сторінками в Markdown | Посібник користувача |
| Knowledge Graph | Інтерактивна візуалізація зв'язків між сутностями | Посібник користувача |
| CRM-дашборд | Веб-UI для керування проєктами та взаємодії з AI | Посібник користувача |
| Local Bridge | WebSocket-реле для локального доступу до файлів з CRM-воркерів | Local Bridge CLI |
| Cloud PM | Постійний чат проєкту з Claude | Посібник користувача |
| ARC CLI | Інструмент командного рядка для скілів, задач, вікі, звітів | Довідник ARC CLI, Посібник користувача |
| Telegram-боти | Master (оркестрація) + Child (AI-проксі на проєкт) | Посібник з Telegram-ботів |
| RAG / Семантичний пошук | Самохостинговано: Cohere embed-multilingual-v3.0 + sqlite-vec; авто-ембединг записів вікі/задач/скілів |
Архітектура RAG, Intelligence Layer |
| Система воркерів | 6 вбудованих воркерів з обмеженими інструментами та моделями | Воркери та Intelligence |
| CRM API | 70+ REST-ендпоінтів з JWT-авторизацією | Довідник API |
| Безпека та шифрування | Фундамент E2EE, шифрування at-rest, ключі відновлення | Архітектура безпеки, Phase 45 E2EE |
| Інтеграція з GitHub | Сповіщення через вебхуки + стрічка в сайдбарі для прив'язаних репозиторіїв | Налаштування інтеграції з GitHub |
| Контроль документації | Pre-push hook + arc wrapup CLI для підтримання документації в актуальному стані |
Довідник ARC CLI |
| База даних | SQLite з WAL, 30+ таблиць, 35 міграцій | Схема бази даних |
| Усунення проблем | Діагностика проблем за симптомами | Усунення проблем |
Статус документів
| Документ | Версія | Останнє оновлення |
|---|---|---|
| Посібник користувача | 2.0 | 2026-04-15 |
| Довідник ARC CLI | 1.0 | 2026-04-27 |
| Посібник з Telegram-ботів | 1.0 | 2026-04-27 |
| Архітектура RAG | 1.0 | 2026-06-05 |
| Воркери та Intelligence | 1.0 | 2026-04-27 |
| Довідник API | 1.0 | 2026-04-27 |
| Схема бази даних | 1.0 | 2026-04-27 |
| Налаштування розробки | 1.0 | 2026-04-27 |
| Усунення проблем | 1.0 | 2026-04-27 |
| Огляд продукту | 2.0 | 2026-04-15 |
| Болі та рішення | 1.0 | 2026-04-03 |
| Конкурентний аналіз | 2.0 | 2026-04-15 |
| Intelligence Layer | 2.0 | 2026-04-15 |
| Звіт про систему 21.5 | 1.0 (історичний) | 2026-04-03 |
| Створення скілів | 1.0 | 2026-04-03 |
| Ізоляція між проєктами | 1.0 | 2026-04-03 |
| Local Bridge CLI | 2.0 | 2026-04-08 |