Documentation Arc OS
Le Système d'Orchestration pour les équipes IA. 70+ endpoints API. Tableau de bord CRM. Recherche sémantique auto-hébergée (Cohere + sqlite-vec, Phase 71). Construit sur Claude Code.
ℹ️ Phase 71 (2026-06-05) : La recherche sémantique passe maintenant par un pipeline RAG auto-hébergé (
shared/rag.ts+ Cohereembed-multilingual-v3.0+sqlite-vec). Le bridge NotebookLM de la Phase 36 a été mis hors service. Les mentions de NotebookLM ci-dessous renvoient à l'ancien setup ; architecture actuelle : RAG Architecture (anglais — traduction à venir).
Navigation rapide
| Je veux... | Aller à |
|---|---|
| Voir ce que fait Arc OS en 5 slides | Fonctionnalités principales — 5 piliers + bouton watch-the-tour |
| Apprendre à utiliser le tableau de bord CRM | Guide utilisateur |
| Connecter ma machine locale aux workers CRM | Local Bridge CLI — zéro dépendance, télécharger et double-cliquer |
| Utiliser ARC CLI pour les tâches, wiki & roadmap | Référence ARC CLI — toutes les commandes avec exemples |
| Configurer les bots Telegram | Guide Bots Telegram — Master Bot, Child Bot, routage worker |
| Utiliser la recherche sémantique (NotebookLM) | Bridge NotebookLM — sync, recherche, niveaux de mémoire |
| Comprendre les Workers & la couche intelligence | Workers & Intelligence — Evals, Context Router, Learnings |
| Parcourir la référence API | Référence API — 70+ endpoints avec paramètres |
| Voir le schéma de base de données | Schéma DB — 30+ tables, 35 migrations, diagramme ER |
| Configurer l'environnement de développement local | Setup développement — Bun, Node, ports, variables env |
| Diagnostiquer un problème | Dépannage — auth, workers, bridge, erreurs frontend |
| Comprendre ce qu'est Arc OS | Vue d'ensemble produit |
| Voir quels problèmes il résout | Points de douleur & solutions |
| Comparer avec d'autres outils | Analyse concurrentielle |
| Apprendre comment fonctionne la couche intelligence | Les 4 piliers |
| Voir les specs système (snapshot Phase 21.5) | Rapport système |
| Créer un nouveau skill | Créer des skills |
| Exécuter plusieurs projets sans mélanger les contextes | Isolation skills multi-projets |
Par section
Produit
Ce qu'est Arc OS, à qui il s'adresse et pourquoi il existe.
- Vue d'ensemble — Capacités principales, résumé architecture, chiffres clés
- Points de douleur & solutions — 5 vrais problèmes que les développeurs rencontrent avec les outils IA et comment Arc OS les résout
- Analyse concurrentielle — Matrice de fonctionnalités vs ChatGPT, Cursor, Windsurf, Devin. Comparaisons de cas d'usage
Architecture
Comment le système fonctionne sous le capot.
- Workers & Couche intelligence — 6 workers intégrés, Binary Evals (6 types de règles), Context Router, Learnings, Karpathy Loop (auto-amélioration nocturne)
- Schéma de base de données — 30+ tables, 35 migrations, clés étrangères, diagramme ER. Mode WAL SQLite, index, pragmas
- Couche intelligence — Les 4 piliers — Binary Evals, Context Router, Reflect Loop, Karpathy Loop. Plus Sage Worker et Marketplace Discovery
- Rapport système — Phase 21.5 — Snapshot historique : carte des modules, inventaire skills, détails infrastructure (Phase 21.5)
Guides
Instructions pas à pas pour utiliser et étendre le système.
- Guide utilisateur — Guide complet du tableau de bord CRM : connexion (OAuth, email, Telegram), espace de travail, workers, tickets, wiki, skills, gestionnaire de fichiers, analytics, et plus
- Référence ARC CLI — Toutes les commandes CLI : login, tickets, skills, wiki, roadmap, report, memory, wrapup (application des docs), github (liaison repo). Avec exemples et variables env
- Guide Bots Telegram — Master Bot (orchestration) + Child Bot (proxy IA). Commandes, claviers inline, routage worker, intégration CRM
- Bridge NotebookLM — Recherche sémantique via Google AI. Auto-sync, cache de requêtes, niveaux de mémoire, téléchargement d'artefacts
- Local Bridge CLI — Bridge zéro-dépendance : télécharger, coller le token, terminé. Binaires autonomes pour Windows, macOS, Linux
- Local Bridge — macOS — Apple Silicon + Intel, workflow Gatekeeper, install.command
- Local Bridge — Linux — x64 + arm64, extraction tar.gz, conseils 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 skills multi-projets — 3 niveaux d'isolation : CLAUDE.md, skills/, Context Router. Evals, learnings, métriques par projet
- Setup développement — Environnement dev local : Bun, Node, ports, variables env, Docker, structure du projet
- Dépannage — Diagnostiquer les problèmes d'auth, worker, bridge, frontend et base de données par symptôme
- Intégration GitHub — Notifications basées sur webhooks + flux sidebar pour les repos GitHub 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 — 70+ endpoints dans 13 catégories : auth, projets, workers, fichiers, skills, chat, wiki, analytics, marketplace, facturation, invitations, mémoire. Formats requête/réponse, codes d'erreur, sécurité
Architecture (Approfondissement)
Architecture interne pour les utilisateurs avancés — composants, décisions et plongées en profondeur par phase.
- Vue d'ensemble architecture — Carte système de niveau supérieur avec diagramme mermaid, liste des composants, flux de données
- Phase 20 — Bots fédérés — Architecture Master + Enfants, watchdog, vault, watchdog
- Phase 45 — Zero-Knowledge E2EE — Dérivation de clé PBKDF2, AES-256-GCM, clés de récupération, cache sessionStorage
- Flux d'agents dual — Split Consultant + Developer, file de specs, flux d'approbation
- Intelligence évolutive — Boucle Karpathy, injection de learnings, amélioration nocturne
- Backend CRM — Internals serveur HTTP Bun, dispatch des routes, primitives SSE/WebSocket
Sécurité
- Vue d'ensemble sécurité — Modèle de menaces, résumé du durcissement, tests smoke au déploiement
- Audit de sécurité 2026-04-23 — Revue multi-passes Sentinel, 13 patches, verdict VERT
Statut du projet
- Roadmap — Calendrier des phases (mermaid) + complétées/en cours/planifiées pour toutes les 52 phases
- Vue d'ensemble produit — Liste complète des fonctionnalités (27 fonctionnalités), réduction v1→v2, pour qui c'est fait
Par mécanisme
Trouve la documentation pour 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 intelligence, Créer des skills |
| Context Router | Évalue les skills par message, injecte les top-5 comme hints | Couche intelligence, Rapport système |
| Reflect Loop | Convertit Fix It / pouces-bas en règles persistantes | Couche intelligence |
| Karpathy Loop | Analyse nocturne des métriques, améliorations approuvées par CEO | Couche intelligence |
| Sage Worker | Analyseur de skills IA, benchmarks, marketplace discovery | Guide utilisateur |
| Système de skills | Ensembles d'instructions portables avec evals et registry | Créer des skills, Multi-projet |
| Isolation de projet | Bots enfants fédérés avec contexte indépendant | Multi-projet, Vue d'ensemble |
| Suivi qualité | Taux de succès par skill, feedback, métriques de durée | Rapport système, Points de douleur |
| Learnings | Mémoire de correction persistante par projet | Couche intelligence, Multi-projet |
| Skill Registry | Index central avec triggers, keywords, catégories | Créer des skills, Multi-projet |
| Workers dynamiques | Système de workers IA extensible (types chat + terminal) | Guide utilisateur, Guide utilisateur |
| Pièces jointes | Uploads de texte, images et PDF dans les messages workers | Guide utilisateur |
| Gestionnaire de fichiers | Navigateur de fichiers côté serveur avec CRUD + git clone | Guide utilisateur |
| Tickets | Suivi de tickets de projet avec log d'activité | Guide utilisateur |
| Wiki | Base de connaissances par projet avec pages markdown | Guide utilisateur |
| Graphe de connaissances | Visualisation interactive des relations d'entités | Guide utilisateur |
| Tableau de bord CRM | UI web pour la gestion de projets et l'interaction IA | Guide utilisateur |
| Local Bridge | Relais WebSocket pour l'accès aux fichiers locaux depuis les workers CRM | Local Bridge CLI |
| Cloud PM | Chat de projet persistant avec Claude | Guide utilisateur |
| ARC CLI | Outil en ligne de commande pour skills, tickets, wiki, rapports | Référence ARC CLI, Guide utilisateur |
| Bots Telegram | Master (orchestration) + Child (proxy IA par projet) | Guide Bots Telegram |
| Bridge NotebookLM | Recherche sémantique via Google AI, auto-sync | Bridge NotebookLM, Couche intelligence |
| Système de workers | 6 workers intégrés avec outils et modèles scopés | Workers & Intelligence |
| API CRM | 70+ endpoints REST avec auth JWT | Référence API |
| Sécurité & Chiffrement | Fondation E2EE, chiffrement au repos, clés de récupération | Architecture sécurité, Phase 45 E2EE |
| Intégration GitHub | Notifications webhook + flux sidebar pour les repos liés | Setup intégration GitHub |
| Application des docs | Hook pre-push + CLI arc wrapup pour maintenir les docs à jour |
Référence ARC CLI |
| Base de données | SQLite avec WAL, 30+ tables, 35 migrations | Schéma DB |
| 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 Bots Telegram | 1.0 | 2026-04-27 |
| Bridge NotebookLM | 1.0 | 2026-04-27 |
| Workers & Intelligence | 1.0 | 2026-04-27 |
| Référence API | 1.0 | 2026-04-27 |
| Schéma DB | 1.0 | 2026-04-27 |
| Setup développement | 1.0 | 2026-04-27 |
| Dépannage | 1.0 | 2026-04-27 |
| Vue d'ensemble produit | 2.0 | 2026-04-15 |
| Points de douleur & solutions | 1.0 | 2026-04-03 |
| Analyse concurrentielle | 2.0 | 2026-04-15 |
| Couche 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-projet | 1.0 | 2026-04-03 |
| Local Bridge CLI | 2.0 | 2026-04-08 |