Arc OS Docs Open in app →

Arc OS — Guide utilisateur

Guide complet de toutes les fonctionnalités du CRM Dashboard Arc OS. Dernière mise à jour : 2026-05-04 (Phase 52.1)

Carte des fonctionnalités en un coup d'œil

graph LR
    Login[1. Login + code d'invitation]
    Dash[2. Vue tous les projets]
    Onb[3. Assistant création de projet]
    Work[4. Workspace + Workers]
    Time[5. Replay Timeline]
    Iss[6. Refonte des tickets]
    Skill[7. Skills + Sage]
    Wiki[8. Wiki + KG]
    NB[9. NotebookLM]
    Bill[10. Essai + Facturation]

    Login --> Dash --> Onb --> Work
    Work --> Time
    Work --> Iss
    Work --> Skill
    Work --> Wiki --> NB
    Dash --> Bill

Table des matières

  1. Démarrage
  2. Mise en page du tableau de bord
  3. Workspace — Workers AI
  4. Pièces jointes
  5. Dossiers — Gestionnaire de fichiers
  6. Worker Studio — Workers personnalisés
  7. Tickets
  8. Wiki
  9. Graphe de connaissances
  10. Skill Evolution
  11. Roadmap
  12. Rapports
  13. Analytics
  14. NotebookLM — Mémoire neurale
  15. Cloud PM — Chat de projet
  16. Paramètres du projet
  17. Intégration Telegram
  18. Thème et paramètres
  19. Raccourcis clavier
  20. Dépannage
  21. Timeline (Phase 47)
  22. Crédits d'essai et facturation
  23. Accès bêta — Codes d'invitation

1. Démarrage

Accès bêta (Phase 52.1) : L'inscription publique est actuellement sur invitation uniquement. Tu as besoin d'un code d'invitation au format arc-XXXX-XXXX pour créer un compte. Voir §23 Accès bêta pour en obtenir un.

Flux d'onboarding — Storyboard

sequenceDiagram
    autonumber
    actor U as Toi
    participant L as Écran de login
    participant E as Email
    participant W as Assistant d'onboarding
    participant M as Master Bot
    participant Wo as Workspace

    U->>L: coller le code d'invitation arc-XXXX-XXXX
    L->>L: valider le format
    U->>L: saisir email + mot de passe + nom
    L-->>E: envoyer lien de vérification (TTL 24h)
    U->>E: cliquer le lien de vérification
    E->>L: redirection → connecté
    L->>W: premier utilisateur → assistant
    U->>W: nommer le projet · choisir un blueprint · saisir la clé Anthropic (optionnel)
    W->>M: POST /api/crm/onboarding/setup
    M->>M: allocatePort() · créer répertoires · cloner blueprint · lancer child bot
    M-->>W: projet prêt
    W->>Wo: redirection vers /project/<name>
    U->>Wo: envoyer le premier message
    Wo-->>U: tokens en streaming via SSE

Budget temps : cible ≤10 min du collage du code d'invitation à la première réponse AI. Étapes 1-5 ≈ 3 min, étapes 6-9 ≈ 2 min, premier chat ≈ 1-5 min selon le clonage du blueprint.

Login

Arc OS supporte trois méthodes d'authentification :

Option A : Email et mot de passe

  1. Ouvre le CRM dashboard (https://arc-os.co ou http://<server>:18888).
  2. Clique Créer un compte sur l'écran de login.
  3. Saisis ton email, nom d'affichage, mot de passe, et ton code d'invitation (arc-XXXX-XXXX).
  4. Vérifie ton email via le lien envoyé dans ta boîte de réception (TTL 24h).
  5. Connecte-toi avec email et mot de passe.

Option B : OAuth (Google / GitHub)

  1. Ouvre l'écran de login du CRM.
  2. Clique Continuer avec Google ou Continuer avec GitHub.
  3. Autorise dans la fenêtre popup.
  4. Tu seras redirigé et connecté automatiquement.

Toutes les méthodes produisent un token JWT (valide 24 heures) stocké dans ton navigateur.

Premiers pas

Après le login, tu verras la vue Tous les projets. Utilise le menu déroulant du sélecteur de workspace dans l'en-tête pour basculer entre les projets, ou clique Tous les projets pour voir le tableau de bord global.

2. Mise en page du tableau de bord

En-tête principal

Élément Description
Menu hamburger Afficher/masquer la barre latérale (bord gauche)
Sélecteur de workspace Menu déroulant pour basculer entre les projets et la vue globale "Tous les projets"
Indicateur de connexion Point vert = connecté, rouge = déconnecté
Bascule de thème Passer du mode clair au mode sombre
Menu utilisateur Profil, Paramètres du compte, Déconnexion

Barre latérale

Menu de navigation repliable (cliquer sur l'hamburger pour basculer). Mobile : tiroir superposé avec fond.

Pages globales (visibles depuis Tous les projets) :

Pages de projet (visibles quand un projet est sélectionné) :

ContextRail (Panneau droit, ≥1280px)

Un panneau de 320px sur le côté droit affichant le contexte du projet à côté de la page active. Sections :

3. Workspace — Workers AI

Le Workspace est ton interface principale pour interagir avec l'AI. Il utilise un système de Workers dynamiques où chaque worker est un agent AI spécialisé.

Workers intégrés

Worker Type Modèle Usage
Consultant Chat Sonnet Analyse read-only, conseils d'architecture, propositions de specs
Developer Terminal Opus Édition de code complète, opérations fichiers, commandes bash

Barre des workers

En haut du Workspace, tu verras des pills (boutons) de workers :

Workers de chat (Consultant)

Interface en bulles de style chat :

Workers de terminal (Developer)

Interface de terminal en flux de logs :

Sélecteur de modèle

Dans la barre d'outils en bas de chaque panneau worker :

Actions rapides (barre du bas)

Bouton Action
/btw Ajouter une note de contexte — invite à saisir du texte, ajouté en tête du prochain message
Pause Mettre en pause le subprocess Claude actuel (SIGSTOP)
Stop Tuer le subprocess Claude actuel (SIGKILL)
Approve Last Envoyer /approve au developer pour la dernière spec

4. Pièces jointes

Tu peux joindre des fichiers à n'importe quel message worker.

Comment joindre

  1. Clique l'icône trombone dans la zone de saisie du message, OU
  2. Glisse-dépose des fichiers sur le workspace, OU
  3. Colle une image depuis le presse-papiers

Types de fichiers supportés

Type Extensions Comment c'est traité
Texte/Code .txt, .md, .py, .js, .ts, .jsx, .tsx, .css, .html, .json, .yaml, .sh, .sql, .csv, .go, .rs, .java, .c, .cpp, .rb, .php, etc. Lu comme texte, contenu injecté dans le message
Images .png, .jpg, .jpeg, .gif, .webp, .svg, .bmp Compressé en JPEG (1600px max, qualité 80%), affiché comme miniature
PDF .pdf Lu en base64, sauvegardé comme fichier temporaire sur le serveur, chemin injecté dans le prompt

Chips de pièces jointes

Après avoir joint un fichier, les fichiers apparaissent sous forme de chips au-dessus de la saisie :

Limites de taille

5. Dossiers — Gestionnaire de fichiers

La page Dossiers fournit un explorateur de fichiers complet pour le répertoire de ton projet sur le serveur.

Navigation

Actions de la barre d'outils

Action Description
Upload Upload multiple fichiers (bouton ou glisser-déposer)
Nouveau dossier Créer un nouveau répertoire (saisir le nom)
Nouveau fichier Créer un fichier avec un contenu initial optionnel
Ajouter un lien Créer un fichier bookmark .link.md (URL + texte)
Cloner dépôt Cloner un dépôt Git (URL HTTPS, superficiel --depth 1)

Menu contextuel (clic droit)

Clic droit sur n'importe quel élément pour des options supplémentaires :

Sur les fichiers :

Sur les dossiers :

Sur l'espace vide :

Panneau de prévisualisation

En cliquant sur un fichier, un panneau latéral s'ouvre montrant :

6. Worker Studio — Workers personnalisés

Tu peux créer des workers AI personnalisés adaptés aux besoins de ton projet.

Créer un worker

  1. Dans le Workspace, clique l'icône engrenage (Worker Studio) dans la barre des workers
  2. Clique + Nouveau Worker
  3. Remplis la configuration du worker :
Champ Description
Label Nom d'affichage (ex. "QA Tester")
Icône Icône emoji pour la pill du worker
Type Chat (style conversation) ou Terminal (flux de logs)
Modèle Modèle AI à utiliser (Sonnet, Opus, Haiku)
Max Turns Nombre maximum de tours du subprocess Claude (1-50)
Outils Quels outils le worker peut utiliser (Read, Edit, Bash, etc.) ou "all"
Répertoires focus Répertoires sur lesquels le worker doit se concentrer
Prompt système Instructions système personnalisées pour le worker
Actifs de contexte Fichiers/répertoires chargés automatiquement comme contexte

Prompts système générés par AI

Clique Générer avec AI pour créer automatiquement un prompt système basé sur :

Token de bot Telegram

Chaque worker peut avoir son propre bot Telegram dédié :

  1. Modifie un worker dans Worker Studio
  2. Dans la section Token de bot Telegram, colle un token de bot (depuis @BotFather)
  3. Clique Connecter
  4. Le bot worker démarre automatiquement et traite les messages indépendamment
  5. Pour supprimer : clique Déconnecter

Cela permet des bots Telegram par worker — ex. un bot Consultant en lecture seule et un bot Developer avec accès complet.

Gérer les workers

7. Tickets

La page Tickets est un tracker de tickets complet pour ton projet.

Fonctionnalités

Depuis le CLI

Les tickets peuvent aussi être gérés via l'ARC CLI :

arc issues                         # lister les tickets ouverts
arc issue create --title "Bug..." # créer un nouveau ticket
arc issue log <id> "Fixed X"      # ajouter une entrée de journal d'activité

8. Wiki

La page Wiki est une base de connaissances pour ton projet.

Fonctionnalités

9. Graphe de connaissances

La page Graphe visualise les relations entre les entités du projet (tickets, pages wiki, skills, phases de roadmap) sous forme de graphe de nœuds interactif.

10. Skill Evolution

La page Skill Evolution (appelée "Skills" dans la barre latérale du projet, "Registre de skills" dans la barre latérale globale) offre une gestion avancée des skills.

Mise en page deux panneaux

Sage Worker

Le Sage est un analyseur de skills propulsé par AI :

Forks de skills

Fork une skill globale pour la personnaliser pour un projet spécifique. Le fork suit la skill parente et peut tirer des mises à jour.

11. Roadmap

La page Roadmap montre le plan de développement du projet organisé par phases.

12. Rapports

La page Rapports affiche les analytics et rapports de session.

13. Analytics

La page Analytics (vue globale) affiche les métriques et la santé système :

14. NotebookLM — Mémoire neurale

Si ton projet a des notebooks NotebookLM liés, ils apparaissent dans le pied de la barre latérale sous "Mémoire neurale" :

La page globale NotebookLMs affiche tous les notebooks liés à travers les projets.

15. Cloud PM — Chat de projet

Le Cloud PM est un chat de projet persistant accessible depuis le Workspace :

16. Paramètres du projet

La page Paramètres du projet (accessible via le bouton Paramètres dans la barre latérale) propose :

17. Intégration Telegram

Le bot Telegram est une interface de commandes alternative. Toutes les fonctionnalités du CRM Dashboard sont également accessibles via Telegram.

Commandes du Master Bot

Commande Description
/status Vue d'ensemble système (santé de tous les projets)
/list Lister tous les projets enregistrés
/health Vérification de santé détaillée pour tous les bots
/watchdog Statut du watchdog et monitoring des child bots
/new_project <name> Assistant de création de projet interactif
/deploy Déployer les mises à jour vers le VPS
/emergency_stop Arrêter immédiatement tous les child bots

Commandes du Child Bot

Commande Description
/ping Vérification de santé du bot
/thread Taille de l'historique du fil
/quality Rapport de métriques de qualité des skills
/learnings Voir les règles de correction accumulées
/specs Voir les specs en attente
/approve <id> Approuver une spec
/reject <id> [reason] Rejeter une spec

Routage des messages

Préfixe Dirigé vers
/c <message> Worker Consultant
/d <message> Worker Developer
/w:<worker_id> <message> Worker personnalisé par ID
(sans préfixe) Rôle actif (par défaut : consultant)

Bots Telegram par worker

Chaque worker peut avoir son propre token de bot Telegram (configuré dans Worker Studio). Quand un worker a son propre bot :

Boutons inline

Après chaque réponse du bot, des boutons inline apparaissent :

18. Thème et paramètres

Mode sombre/clair

Clique la bascule de thème dans l'en-tête principal pour basculer entre les thèmes clair et sombre. Ta préférence est sauvegardée dans localStorage.

Paramètres du compte

Clique ton avatar → Paramètres du compte pour configurer :

Système de couleurs

Le tableau de bord utilise des propriétés CSS personnalisées pour un thème cohérent :

Couleurs de statut

Couleur Signification
Vert Sain / Succès / En ligne
Jaune/Orange Dégradé / Avertissement / Traitement
Rouge Hors ligne / Erreur / Échec
Violet Thinking / Brouillon de spec
Bleu En exécution / Actif

19. Raccourcis clavier

Raccourci Contexte Action
Entrée Saisie de message Envoyer le message
Maj+Entrée Zone de texte chat Nouvelle ligne
Échap N'importe quelle modale Fermer la modale/superposition
Clic droit Explorateur de fichiers Menu contextuel

20. Dépannage

"Connection lost" / Indicateur rouge

Le tableau de bord a perdu la connexion au serveur. Vérifier :

  1. Le VPS est-il en marche ? (ssh dans le serveur, vérifier tmux ls)
  2. nginx est-il en marche ? (systemctl status nginx)
  3. Le master bot est-il en marche ? (curl http://<server>:19210/api/master/health)

"Unauthorized" / Boucle de login

Ton token JWT a expiré (TTL 24h). Reconnecte-toi via email/mot de passe ou OAuth.

Le panneau worker n'affiche aucune sortie

  1. Vérifier que le flux SSE est connecté (DevTools du navigateur → Réseau → filtrer par EventStream)
  2. Le worker n'a peut-être pas encore produit de sortie — envoyer un message d'abord
  3. Essayer de rafraîchir la page (F5)

L'upload de fichier échoue

Bot ne répond pas dans Telegram

  1. Vérifier la santé du bot : envoyer /ping
  2. Si pas de réponse, SSH sur le VPS et vérifier tmux : tmux attach -t citadel-child
  3. Vérifier les logs : tail -50 /var/log/citadel/<project>/system-$(date +%Y-%m-%d).log
  4. Redémarrer via le CRM : Paramètres du projet → Restart Bot, ou /deploy dans le Master Bot

Erreurs CORS dans la console du navigateur

Le domaine du tableau de bord doit être dans CRM_ALLOWED_ORIGINS. Autorisés par défaut :

invite_required 403 à l'inscription (Phase 52.1)

L'inscription publique est restreinte. Soit :

plan_limit_reached 402 à la création de projet / worker (Phase 51)

Ton compte a atteint la limite de ton niveau :

Passer au niveau supérieur via Paramètres → Facturation (L'UI Stage 3 est en cours). Pour l'instant, contacter le CEO.

21. Timeline (Phase 47)

Une page d'observabilité de style DAW qui te permet de rejouer la session d'un worker comme si c'était une console de mixage audio.

sequenceDiagram
    participant U as Toi
    participant W as Workspace
    participant T as Timeline
    participant DB as table timeline_events

    U->>W: envoyer un message au Worker A
    W->>DB: ajouter des événements (think · tool · response)
    U->>T: ouvrir la page Timeline
    T->>DB: requêter les événements groupés par worker
    T-->>U: afficher les lanes + la tête de lecture
    U->>T: scrubber la tête de lecture / mute/solo des lanes

Fonctionnalités

Quand l'utiliser

22. Crédits d'essai et facturation (Phases 50-51)

Arc OS utilise l'API Anthropic en ton nom pour les workers chat/terminal. La plateforme de base est gratuite, mais les coûts de tokens sont répercutés sur ton compte.

Crédits d'essai (Phase 50)

Facturation Stripe (Phase 51 — Stage 1 actif, UI Stage 3 en attente)

Plan Prix Projets Workers
Gratuit 0 $ 1 5
Min 4,99 $/mois 5 OU 25 (sémantique OR) sémantique OR
Max 11,99 $/mois 20 OU 150 sémantique OR
Bêta manuel Illimité Illimité

Limites sémantique OR : "5 OU 25" signifie que tu peux avoir soit ≤5 projets, soit ≤25 workers sur tous les projets — selon ce que tu atteins en premier.

Apporter ta propre clé

Si tu préfères payer Anthropic directement :

  1. Obtenir une clé API Anthropic sur https://console.anthropic.com
  2. Paramètres du compte → Clés API → coller la clé
  3. Ou utiliser le Local Bridge CLI pour exécuter les workers sur ta propre machine gratuitement

endpoint de statut

GET /api/crm/billing/status retourne :

23. Accès bêta — Codes d'invitation (Phase 52.1)

Arc OS est en bêta Friends & Family. L'inscription publique est fermée jusqu'à ce que les critères de succès F&F soient validés.

Obtenir une invitation

Format du code

arc-XXXX-XXXX — préfixe arc- + 8 caractères hex en deux groupes séparés par un tiret (dérivé de crypto.randomBytes).

Utiliser un code

  1. Aller au formulaire d'inscription
  2. Coller le code dans le champ Code d'invitation (saisie monospace, validée côté client)
  3. Le code est consommé atomiquement lors d'une inscription réussie — un code par compte
  4. Si le code est déjà utilisé ou révoqué : 403 invite_required avec un lien vers le canal de feedback

Avantages des Founding Members

Admin : créer et révoquer des codes (CEO uniquement)

arc invites generate --count 5            # créer 5 nouveaux codes
arc invites list                          # afficher les codes actifs + qui les a utilisés
arc invites revoke arc-AAAA-BBBB          # invalider un code fuité

Équivalents REST : POST/GET/DELETE /api/crm/admin/invites (rôle admin requis).

Maintenu par l'équipe Arc OS. Mis à jour après chaque complétion de phase.