Документація Arc OS
Система оркестрації для команд AI. 70+ API endpoints. CRM Dashboard. Семантичний пошук. Збудовано на Claude Code.
🇺🇦 Ця сторінка — повний український переклад. Окремі гайди можуть тимчасово показуватися англійською — у такому випадку ти побачиш банер про fallback зверху сторінки. Допомогти з перекладом можна через канал
@arcos_beta_feedback.
Швидка навігація
| Я хочу… | Перейти до |
|---|---|
| Подивитися що робить Arc OS за 5 слайдів | Основні фічі — 5 стовпів + кнопка watch-the-tour |
| Навчитися користуватися CRM dashboard | Гайд користувача |
| Підключити локальну машину до CRM workers | Local Bridge CLI — без залежностей, завантаж і запусти |
| Користуватись ARC CLI для задач, wiki і roadmap | Довідник ARC CLI — усі команди з прикладами |
| Налаштувати Telegram-боти | Гайд по Telegram-ботах — Master Bot, Child Bot, маршрутизація workers |
| Користуватись семантичним пошуком (NotebookLM) | NotebookLM Bridge — sync, пошук, рівні памʼяті |
| Розібратись із Workers та Intelligence Layer | Workers та Intelligence — Evals, Context Router, Learnings |
| Переглянути API reference | API Reference — 70+ endpoints із параметрами |
| Подивитися схему БД | Схема БД — 30+ таблиць, 35 міграцій, ER діаграма |
| Налаштувати локальну розробку | Development Setup — Bun, Node, порти, env vars |
| Діагностувати проблему | Troubleshooting — auth, workers, bridge, frontend errors |
| Зрозуміти що таке Arc OS | Огляд продукту |
| Побачити які проблеми вирішує | Pain Points & Solutions |
| Порівняти з іншими інструментами | Competitive Analysis |
| Дізнатись як працює Intelligence Layer | Чотири стовпи |
| Подивитися system specs (зріз Phase 21.5) | System Report |
| Створити нову skill | Створення Skills |
| Запустити багато проєктів без context-mixing | Ізоляція skills між проєктами |
За розділами
Продукт
Що таке Arc OS, для кого, і навіщо існує.
- Огляд — основні можливості, архітектура, ключові цифри
- Pain Points & Solutions — 5 реальних проблем, які розвʼязує Arc OS
- Competitive Analysis — порівняння з ChatGPT, Cursor, Windsurf, Devin
Архітектура
Як система працює всередині.
- Workers та Intelligence Layer — 6 вбудованих workers, Binary Evals (6 типів правил), Context Router, Learnings, Karpathy Loop (нічне самовдосконалення)
- Схема БД — 30+ таблиць, 35 міграцій, foreign keys, ER діаграма. SQLite WAL mode, індекси, pragmas
- Intelligence Layer — 4 стовпи — Binary Evals, Context Router, Reflect Loop, Karpathy Loop. Плюс Sage Worker і Marketplace Discovery
- System Report — Phase 21.5 — історичний знімок: module map, інвентар skills, інфраструктура (Phase 21.5)
Гайди
Покрокові інструкції для використання та розширення системи.
- Гайд користувача — повний CRM dashboard: вхід (OAuth, email, Telegram), workspace, workers, issues, wiki, skills, файловий менеджер, аналітика
- Довідник ARC CLI — усі CLI-команди: login, issues, skills, wiki, roadmap, report, memory, wrapup (контроль документації), github (привʼязка репо). Із прикладами та env vars
- Гайд по Telegram-ботах — Master Bot (оркестрація) + Child Bot (AI proxy). Команди, inline keyboards, маршрутизація workers, інтеграція з CRM
- NotebookLM Bridge — семантичний пошук через Google AI. Auto-sync, query cache, рівні памʼяті, завантаження артефактів
- 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, антивірус-нюанси
- Створення Skills — пишемо skill.md, додаємо evals.json, реєструємо в _registry.json, тестуємо pipeline
- Ізоляція skills між проєктами — 3 рівні ізоляції: CLAUDE.md, skills/, Context Router. Per-project evals, learnings, метрики
- Development Setup — локальне середовище: Bun, Node, порти, env vars, Docker, структура проєкту
- Troubleshooting — діагностика auth, worker, bridge, frontend і database проблем по симптомах
- Інтеграція з GitHub — webhook-нотифікації + sidebar feed для привʼязаних репо. HMAC-SHA256, multi-repo per project, Telegram alerts (Phase 49.3)
API
- CRM API Reference — 70+ endpoints у 13 категоріях: auth, projects, workers, files, skills, chat, wiki, analytics, marketplace, billing, invites, memory. Формати запитів/відповідей, коди помилок, безпека
Архітектура (deep dive)
Внутрішня архітектура для досвідчених — компоненти, рішення, deep dive по фазах.
- Огляд архітектури — top-level system map з mermaid діаграмою, список компонентів, потоки даних
- Phase 20 — федеровані боти — Master + Children, watchdog, vault
- Phase 45 — Zero-Knowledge E2EE — PBKDF2 derivation, AES-256-GCM, recovery keys, sessionStorage caching
- Dual-Agent Flow — Consultant + Developer split, spec queue, потік апрувів
- Evolving Intelligence — Karpathy loop, інʼєкція learnings, нічне покращення
- CRM Backend — внутрішня будова Bun HTTP сервера, route dispatch, SSE/WebSocket primitives
Безпека
- Огляд безпеки — модель загроз, hardening summary, smoke tests після деплою
- Аудит безпеки 2026-04-23 — Sentinel multi-pass review, 13 патчів, GREEN verdict
Стан проєкту
- Roadmap — phase timeline (mermaid) + completed/in-progress/planned для всіх 52 фаз
- Огляд продукту — повний список фіч (27 фіч), v1→v2 reduction, цільова аудиторія
За механізмом
Знайти документацію за конкретною фічею Arc OS.
| Механізм | Що робить | Документація |
|---|---|---|
| Binary Evals | Декларативні правила, що валідують кожну відповідь AI | Intelligence Layer, Створення Skills |
| Context Router | Оцінює skills для кожного повідомлення, інʼєктить топ-5 як підказки | Intelligence Layer |
| Reflect Loop | Перетворює Fix It / thumbs-down на постійні правила | Intelligence Layer |
| Karpathy Loop | Нічний аналіз метрик → CEO-ухвалені покращення | Intelligence Layer |
| Sage Worker | AI-аналізатор skills, бенчмарки, marketplace discovery | Гайд користувача |
| Skill System | Портативні набори інструкцій з evals і registry | Створення Skills, Multi-Project |
| Project Isolation | Federated child bots з незалежним контекстом | Multi-Project |
| Quality Tracking | Per-skill success rate, фідбек, тривалість | System Report |
| Learnings | Постійна памʼять про корекції в межах проєкту | Intelligence Layer |
| Dynamic Workers | Розширювана система AI workers (chat + terminal) | Гайд користувача |
| File Attachments | Завантаження text/images/PDF до повідомлень | Гайд користувача |
| File Manager | Серверний файловий браузер з CRUD + git clone | Гайд користувача |
| Issues | Issue-трекер проєкту з логом активності | Гайд користувача |
| Wiki | Per-project база знань на markdown | Гайд користувача |
| Knowledge Graph | Інтерактивна візуалізація звʼязків між сутностями | Гайд користувача |
| Local Bridge | WebSocket relay для доступу CRM workers до локальних файлів | Local Bridge CLI |
| Cloud PM | Постійний project chat з Claude | Гайд користувача |
| ARC CLI | CLI-інструмент для skills, issues, wiki, reports | Довідник ARC CLI |
| Telegram Bots | Master (оркестрація) + Child (AI proxy per project) | Telegram Bots |
| NotebookLM Bridge | Семантичний пошук через Google AI, auto-sync | NotebookLM Bridge |
| Worker System | 6 вбудованих workers зі scoped tools і моделями | Workers та Intelligence |
| CRM API | 70+ REST endpoints з JWT auth | API Reference |
| Security & Encryption | Фундамент E2EE, at-rest шифрування, recovery keys | Огляд безпеки, Phase 45 E2EE |
| GitHub Integration | Webhook-нотифікації + sidebar feed для привʼязаних репо | Інтеграція з GitHub |
| Database | SQLite з WAL, 30+ таблиць, 35 міграцій | Схема БД |
| Troubleshooting | Діагностика проблем по симптомах | Troubleshooting |
Статус документів
| Документ | Версія | Останнє оновлення |
|---|---|---|
| Гайд користувача | 2.1 | 2026-05-04 |
| Local Bridge CLI | 2.1 | 2026-05-05 |
| ARC CLI Reference | 1.0 | 2026-04-27 |
| Telegram Bots Guide | 1.0 | 2026-04-27 |
| NotebookLM Bridge | 1.0 | 2026-04-27 |
| Workers та Intelligence | 1.0 | 2026-04-27 |
| API Reference | 1.0 | 2026-04-27 |
| Схема БД | 1.1 | 2026-05-04 |
| Огляд продукту | 2.1 | 2026-05-04 |
| Roadmap | (auto) | 2026-05-04 |