Documentation Arc OS
Le Système d'orchestration pour équipes IA. Plus de 70 endpoints API. Dashboard CRM. Recherche sémantique. Construit sur Claude Code.
Navigation rapide
| Je veux… | Aller à |
|---|---|
| Voir ce que fait Arc OS en 5 slides | Fonctionnalités principales — 5 piliers + bouton « regarder le tour » |
| Obtenir des réponses rapides (tarifs, Cowork vs Arc OS, internals) | FAQ — produit, architecture, sécurité & données |
| Apprendre à utiliser le dashboard CRM | Guide utilisateur |
| Connecter ma machine locale aux workers du CRM | Local Bridge CLI — zéro dépendance, télécharge et double-clique |
| Utiliser ARC CLI pour les tâches, le wiki et la roadmap | Référence ARC CLI — toutes les commandes avec exemples |
| Configurer les bots Telegram | Guide des bots Telegram — Master Bot, Child Bot, routage des workers |
| Utiliser la recherche sémantique sur tout le contenu d'un projet | Architecture RAG — embeddings Cohere + sqlite-vec, remplace NotebookLM depuis la Phase 71 |
| Comprendre les Workers & la couche d'intelligence | Workers & Intelligence — Evals, Context Router, Learnings |
| Parcourir la référence API | Référence API — plus de 70 endpoints avec paramètres |
| Voir le schéma de la base de données | Schéma de base de données — plus de 30 tables, 35 migrations, diagramme ER |
| Configurer l'environnement de dev local | Configuration du développement — Bun, Node, ports, variables d'env |
| Diagnostiquer un problème | Dépannage — erreurs d'auth, workers, bridge, frontend |
| Comprendre ce qu'est Arc OS | Vue d'ensemble du produit |
| Voir quels problèmes il résout | Points de douleur & solutions |
| Comparer avec d'autres outils | Analyse concurrentielle |
| Apprendre comment fonctionne la couche d'intelligence | Les 4 piliers |
| Voir un instantané précoce du système (historique) | Rapport système — archive Phase 21.5 |
| Créer un nouveau skill | Créer des skills |
| Faire tourner plusieurs projets sans mélange de contexte | Isolation des skills multi-projets |
Par section
Produit
Ce qu'est Arc OS, à qui il s'adresse et pourquoi il existe.
- Vue d'ensemble — Capacités de base, résumé de l'architecture, chiffres clés
- Points de douleur & solutions — 5 vrais problèmes que rencontrent les développeurs avec les outils IA et comment Arc OS résout chacun
- Analyse concurrentielle — Matrice de fonctionnalités vs ChatGPT, Cursor, Windsurf, Devin. Comparaisons de cas d'usage
Architecture
Comment le système fonctionne en coulisses.
- Workers & couche d'intelligence — 13 presets de rôles de workers, Binary Evals (6 types de règles), Context Router, Learnings, Karpathy Loop (auto-amélioration nocturne)
- Schéma de base de données — plus de 30 tables, 35 migrations, clés étrangères, diagramme ER. SQLite en mode WAL, index, pragmas
- Couche d'intelligence — Les 4 piliers — Binary Evals, Context Router, Reflect Loop, Karpathy Loop. Plus Sage Worker et la découverte marketplace
- Rapport système — Phase 21.5 (archive) — Instantané historique du début du développement ; conservé pour référence, remplacé par les pages d'architecture ci-dessus
Guides
Instructions pas à pas pour utiliser et étendre le système.
- Guide utilisateur — Guide complet du dashboard CRM : login (OAuth, email, Telegram), workspace, workers, issues, wiki, skills, gestionnaire de fichiers, analytics, et plus
- Référence ARC CLI — Toutes les commandes CLI : login, issues, skills, wiki, roadmap, report, memory, wrapup (application de la doc), github (liaison de repo). Avec exemples et variables d'env
- Guide des bots Telegram — Master Bot (orchestration) + Child Bot (proxy IA). Commandes, claviers inline, routage des workers, intégration CRM
- Architecture RAG — Recherche sémantique auto-hébergée depuis la Phase 71 : Cohere embed-multilingual-v3.0 +
sqlite-vecdans la SSOT SQLite existante. Remplace l'ancien bridge NotebookLM (décommissionné le 2026-06-05) - Local Bridge CLI — Bridge zéro dépendance : télécharge, colle le token, c'est fait. Binaires autonomes pour Windows, macOS, Linux
- Local Bridge — macOS — Apple Silicon + Intel, workflow Gatekeeper, install.command
- Local Bridge — Linux — x64 + arm64, extraction tar.gz, astuces ripgrep
- Local Bridge — Windows — Windows 10/11, SmartScreen, particularités antivirus
- Créer des skills — Écrire skill.md, ajouter evals.json, enregistrer dans _registry.json, tester le pipeline
- Isolation des skills multi-projets — 3 niveaux d'isolation : CLAUDE.md, skills/, Context Router. Evals, learnings et métriques par projet
- Configuration du développement — Environnement de dev local : Bun, Node, ports, variables d'env, Docker, structure du projet
- Dépannage — Diagnostiquer les problèmes d'auth, de worker, de bridge, de frontend et de base de données par symptôme
- Intégration GitHub — Notifications par webhook + feed dans la sidebar pour les repos liés. HMAC-SHA256, multi-repo par projet, alertes Telegram (Phase 49.3)
- Configuration email — Runbook opérationnel pour
[email protected]: Cloudflare Email Routing (gratuit, 10 min), DMARC, chemin de migration vers Zoho/Workspace
API
- Référence API CRM — plus de 70 endpoints répartis en 13 catégories : auth, projets, workers, fichiers, skills, chat, wiki, analytics, marketplace, facturation, invitations, memory. Formats requête/réponse, codes d'erreur, sécurité
Architecture (approfondissement)
Architecture interne pour utilisateurs avancés — composants, décisions et approfondissements par phase.
- Vue d'ensemble de l'architecture — Carte du système de haut niveau avec diagramme mermaid, liste des composants, flux de données
- Phase 20 — Bots fédérés — Architecture Master + Children, watchdog, vault, watchdog
- Phase 45 — E2EE Zero-Knowledge — Dérivation de clé PBKDF2, AES-256-GCM, clés de récupération, mise en cache sessionStorage
- Flux dual-agent — Séparation Consultant + Developer, file de specs, flux d'approbation
- Intelligence évolutive — Karpathy loop, injection de learnings, amélioration nocturne
- Backend CRM — Internals du serveur HTTP Bun, dispatch des routes, primitives SSE/WebSocket
Sécurité
- Vue d'ensemble de la sécurité — Modèle de menace, résumé du durcissement, smoke tests au déploiement
- Audit de sécurité 2026-04-23 — Revue multi-passes Sentinel, 13 patches, verdict VERT
Statut du projet
- Roadmap — Chronologie des phases (mermaid) + terminé/en cours/prévu pour les 52 phases
- Vue d'ensemble du produit — Liste complète des fonctionnalités (27), réduction v1→v2, à qui ça s'adresse
Par mécanisme
Trouve la documentation d'une fonctionnalité Arc OS spécifique.
| Mécanisme | Ce qu'il fait | Docs |
|---|---|---|
| Binary Evals | Règles déclaratives qui valident chaque réponse IA | Couche d'intelligence, Créer des skills |
| Context Router | Note les skills par message, injecte le top-5 comme hints | Couche d'intelligence, Rapport système |
| Reflect Loop | Convertit Fix It / pouce-bas en règles persistantes | Couche d'intelligence |
| Karpathy Loop | Analyse nocturne des métriques, améliorations approuvées par le CEO | Couche d'intelligence |
| Sage Worker | Analyseur de skills par IA, benchmarks, découverte marketplace | Guide utilisateur |
| Système de skills | Jeux d'instructions portables avec evals et registry | Créer des skills, Multi-projets |
| Isolation de projet | Child bots fédérés avec contexte indépendant | Multi-projets, Vue d'ensemble |
| Suivi de qualité | Taux de succès par skill, feedback, métriques de durée | Rapport système, Points de douleur |
| Learnings | Mémoire de corrections persistante par projet | Couche d'intelligence, Multi-projets |
| Skill Registry | Index central avec triggers, mots-clés, catégories | Créer des skills, Multi-projets |
| Workers dynamiques | Système de workers IA extensible (types chat + terminal) | Guide utilisateur, Guide utilisateur |
| Pièces jointes | Uploads de texte, images et PDF vers les messages des workers | Guide utilisateur |
| Gestionnaire de fichiers | Navigateur de fichiers côté serveur avec CRUD + git clone | Guide utilisateur |
| Issues | Suivi des issues du projet avec log d'activité | Guide utilisateur |
| Wiki | Base de connaissances par projet avec pages markdown | Guide utilisateur |
| Knowledge Graph | Visualisation interactive des relations entre entités | Guide utilisateur |
| Dashboard CRM | UI web pour la gestion de projet et l'interaction IA | Guide utilisateur |
| Local Bridge | Relais WebSocket pour l'accès aux fichiers locaux depuis les workers du CRM | Local Bridge CLI |
| Cloud PM | Chat de projet persistant avec Claude | Guide utilisateur |
| ARC CLI | Outil en ligne de commande pour skills, issues, wiki, rapports | Référence ARC CLI, Guide utilisateur |
| Bots Telegram | Master (orchestration) + Child (proxy IA par projet) | Guide des bots Telegram |
| RAG / Recherche sémantique | Auto-hébergé : Cohere embed-multilingual-v3.0 + sqlite-vec ; embedding auto des écritures wiki/issue/skill |
Architecture RAG, Couche d'intelligence |
| Système de workers | 6 workers intégrés avec outils et modèles cadrés | Workers & Intelligence |
| API CRM | plus de 70 endpoints REST avec auth JWT | Référence API |
| Sécurité & chiffrement | Fondation E2EE, chiffrement at-rest, clés de récupération | Architecture de sécurité, Phase 45 E2EE |
| Intégration GitHub | Notifications par webhook + feed dans la sidebar pour les repos liés | Configuration de l'intégration GitHub |
| Application de la doc | Hook pre-push + CLI arc wrapup pour garder la doc synchronisée |
Référence ARC CLI |
| Base de données | SQLite avec WAL, plus de 30 tables, 35 migrations | Schéma de base de données |
| Dépannage | Diagnostiquer les problèmes par symptôme | Dépannage |
Statut des documents
| Document | Version | Dernière mise à jour |
|---|---|---|
| Guide utilisateur | 2.0 | 2026-04-15 |
| Référence ARC CLI | 1.0 | 2026-04-27 |
| Guide des bots Telegram | 1.0 | 2026-04-27 |
| Architecture RAG | 1.0 | 2026-06-05 |
| Workers & Intelligence | 1.0 | 2026-04-27 |
| Référence API | 1.0 | 2026-04-27 |
| Schéma de base de données | 1.0 | 2026-04-27 |
| Configuration du développement | 1.0 | 2026-04-27 |
| Dépannage | 1.0 | 2026-04-27 |
| Vue d'ensemble du produit | 2.0 | 2026-04-15 |
| Points de douleur & solutions | 1.0 | 2026-04-03 |
| Analyse concurrentielle | 2.0 | 2026-04-15 |
| Couche d'intelligence | 2.0 | 2026-04-15 |
| Rapport système 21.5 | 1.0 (historique) | 2026-04-03 |
| Créer des skills | 1.0 | 2026-04-03 |
| Isolation multi-projets | 1.0 | 2026-04-03 |
| Local Bridge CLI | 2.0 | 2026-04-08 |