Bien démarrer avec Arc OS
Arc OS — Système d'Orchestration IA pour les équipes de développement. Ce guide explique ce qu'est Arc OS, pourquoi il existe et comment commencer à l'utiliser efficacement.
Qu'est-ce qu'Arc OS ?
Arc OS est une plateforme qui te permet de constituer et de gérer une équipe de développement IA personnelle construite sur Claude.
L'idée centrale : au lieu d'ouvrir un nouveau chat IA chaque fois que tu as besoin d'aide, tu disposes de workers IA persistants qui :
- Connaissent ta base de code, ton architecture et ton historique
- Ne perdent jamais le contexte entre les sessions
- Se spécialisent chacun dans un rôle précis
- Partagent la même base de connaissances projet
Tu constitues ton équipe une seule fois. Puis tu travailles avec elle — via CLI, IDE ou web.
L'idée principale : un LLM, un contexte partagé, des rôles spécialisés
La plupart des développeurs utilisent l'IA comme un chat jetable — coller le code, obtenir la réponse, oublier.
Arc OS est différent :
Un seul LLM (Claude) — tous les workers fonctionnent sur Claude. Nous avons choisi Claude pour sa longue fenêtre de contexte, son respect des instructions et sa qualité de code. Tu apportes ton propre abonnement Claude.
Aucune perte de contexte — chaque worker a accès à :
- Ton wiki projet (décisions d'architecture, conventions, notes)
- Tes skills (instructions personnalisées pour des tâches spécifiques)
- Ton suivi de tickets (ce qui est en cours, ce qui est terminé)
- L'historique des sessions (ce qui a été discuté auparavant)
Des rôles spécialisés — chaque worker a une personnalité, des permissions et un objectif différents :
| Worker | Rôle | Ce qu'il fait |
|---|---|---|
| Developer | Accès complet | Écrit du code, exécute des commandes, commite, débogue |
| Consultant | Lecture seule | Relit, explique, conseille — ne touche jamais aux fichiers |
| Designer | Focus UI/UX | Design de composants, accessibilité, systèmes visuels |
| Sentinel | Sécurité | Audite le code, trouve les vulnérabilités, durcit les systèmes |
| Archivist | Documentation | Rédige la documentation, maintient le wiki à jour, génère des rapports |
| Product Owner | Planification | Gère la roadmap, crée les tickets, priorise le backlog |
Tu peux aussi créer des workers personnalisés pour tes besoins spécifiques.
Qu'est-ce qu'un projet ?
Un projet dans Arc OS correspond à une base de code ou un produit sur lequel tu travailles.
Chaque projet possède :
- Son propre ensemble de workers (Developer, Consultant, etc.)
- Son propre wiki (docs d'architecture, décisions, conventions)
- Ses propres skills (instructions personnalisées injectées dans les workers)
- Son propre suivi de tickets (tâches, bugs, fonctionnalités)
- Son propre historique de sessions
Tu peux avoir plusieurs projets — un par produit, client ou dépôt.
La façon principale de travailler : le bridge CLI
Le bridge CLI est l'interface principale d'Arc OS. Il connecte ton terminal local ou ton IDE directement à tes workers IA.
# Start a Developer session on project "my-app"
arc my-app developer
# Start a Consultant (read-only) session
arc my-app consultant
# Continue the previous session (restores context)
arc my-app developer continue
Quand tu exécutes arc <project> <worker>, le worker :
- Charge ton wiki projet, tes skills et le ticket actif
- Ouvre une session Claude interactive dans ton terminal
- A un accès complet à ton système de fichiers local (Developer) ou en lecture seule (Consultant)
- Sauvegarde le contexte de session pour la prochaine fois
Pourquoi CLI-first ?
- Fonctionne dans n'importe quel terminal (macOS, Linux, Windows)
- S'intègre à VS Code, Cursor, JetBrains via le panneau terminal
- Pas de changement de contexte — reste dans ton éditeur
- Conscient de Git : le worker voit ta branche courante, les changements stagés, les commits récents
Commandes clés du CLI arc
arc <project> <worker> # Start a session
arc <project> <worker> continue # Resume previous session
arc sessions <project> # Browse past sessions
arc issues # List open issues
arc issue create --title "..." # Create new issue
arc issue log <id> "progress note" # Log progress
arc skill <name> # Load a skill into context
arc wiki # Browse project wiki
arc roadmap # View project roadmap
arc retro <project> # Reconstruct issues from history
Comment démarrer
Étape 1 — Installer le CLI arc
Télécharge le binaire pour ton OS depuis le tableau de bord Arc OS (Settings → CLI).
# macOS / Linux
chmod +x arc-linux-x64
sudo mv arc-linux-x64 /usr/local/bin/arc
arc --version
Étape 2 — Créer ton premier projet
Dans le tableau de bord CRM :
- Clique sur New Project
- Donne-lui un nom et connecte ton dépôt GitHub
- Le système crée automatiquement ton équipe de workers
Étape 3 — Ajouter des skills (optionnel mais recommandé)
Les skills sont des ensembles d'instructions personnalisées qui rendent les workers plus pertinents sur ton projet :
- Conventions de style de code
- Patterns d'architecture que tu utilises
- Bibliothèques et frameworks de ta stack
- Ce que le worker doit toujours / ne jamais faire
Va dans Skill Registry → Generate — le système lit ta base de code et suggère des skills automatiquement.
Étape 4 — Démarrer ta première session
arc my-project developer
Le worker Developer se présentera, chargera le contexte de ton projet et attendra ta première tâche.
Étape 5 — Connecter Telegram (optionnel)
Si tu veux envoyer des messages rapides aux workers depuis ton téléphone ou loin de l'ordinateur, connecte Telegram via Settings → Telegram Bot.
Telegram est optionnel — toutes les fonctionnalités principales passent par le CLI.
Comment les workers partagent leurs connaissances
Tous les workers d'un même projet partagent :
Wiki — documents markdown que toi ou les workers écrivez sur le projet. Décisions d'architecture, conventions d'API, « choses à savoir », notes d'onboarding. Les workers lisent le wiki automatiquement au démarrage de la session.
Skills — ensembles d'instructions réutilisables. Un skill « TypeScript strict mode » ou « toujours écrire les tests d'abord » est injecté dans chaque session de worker pertinente.
Tickets — quand un worker travaille sur le ticket #42, il connaît ce contexte. Les autres workers peuvent voir ce qui est en cours.
Historique des sessions — les workers peuvent se référer à ce qui a été discuté dans les sessions précédentes via arc sessions ou continue.
Standard Cloud — Workspace toujours actif
Standard Cloud est disponible dès maintenant. Avec un abonnement Standard Cloud, tu obtiens un conteneur Docker dédié sur les serveurs Arc OS (Hetzner).
Ce que cela t'apporte
Des fichiers projet persistants sur VPS
Ton répertoire /workspace vit sur le serveur — pas sur ton laptop. Les fichiers sont là quand tu reviens, même après avoir éteint ton ordinateur.
/workspace/my-project/ ← your code, always available
/home/arcuser/.claude/ ← Claude auth, persisted
/home/arcuser/.ssh/ ← GitHub SSH key, persisted
Synchronisation GitHub via SSH
Le conteneur dispose d'une clé SSH dédiée connectée à ton compte GitHub. Tu fais git clone une fois — puis git pull / push depuis n'importe où sans te ré-authentifier.
# Inside your container workspace
cd /workspace
git clone [email protected]:you/project.git # once
git pull # any time, from any device
Accès depuis n'importe quel appareil Ouvre le CRM Arc OS depuis ton téléphone, tablette ou un autre ordinateur — ton workspace et tes fichiers sont exactement là où tu les as laissés. Fini le problème « j'ai laissé le projet sur mon autre machine ».
Reprendre là où tu t'es arrêté
# In Telegram, next morning:
/continue
# Worker responds:
# Yesterday: finished auth middleware, tests remaining
# Continuing...
Le worker reprend le contexte de la session précédente et continue à travailler — pendant que tu bois ton café.
Ce qui est inclus
| Fonctionnalité | Free / Local | Standard Cloud |
|---|---|---|
| arc CLI (local) | ✅ | ✅ |
| Tableau de bord CRM | ✅ | ✅ |
| Workspace VPS persistant | ❌ | ✅ |
| Intégration SSH GitHub | ❌ | ✅ |
| Accès depuis n'importe quel appareil | ❌ | ✅ |
| /continue depuis Telegram | ❌ | ✅ |
| Les fichiers survivent à la fermeture du laptop | ❌ | ✅ |
Comment activer
- Va dans Billing → Standard Cloud
- Abonne-toi (voir le tarif actuel dans le tableau de bord)
- Clique sur Create Cloud Workspace — le conteneur est prêt en moins de 60 secondes
- Connecte Claude Code (ton abonnement Claude Pro)
- Connecte ta clé SSH GitHub
- Clone ton projet dans
/workspace
Ton abonnement Claude Pro/Max est séparé — tu apportes le tien. Arc OS ne facture pas l'utilisation de Claude.
Ce qu'Arc OS n'est PAS
- Pas un agent autonome — les workers ne tournent pas en arrière-plan sans toi. Chaque session démarre quand tu l'ouvres.
- Pas un bot de support client — les workers s'adressent à toi (le développeur), pas à tes utilisateurs finaux.
- Pas un outil d'automatisation de workflows — Arc OS ne se connecte pas seul à des API externes. Les workers t'aident à écrire le code qui le fait.
- Pas un remplacement de Claude.ai — Arc OS est construit sur Claude, avec en plus le contexte projet et la structure d'équipe.
Premières questions fréquentes
Q : Ai-je besoin de Telegram ? Non. Telegram est optionnel. Le bridge CLI est l'interface principale.
Q : Les workers partagent-ils le contexte entre eux ? Oui — via le wiki, les skills et le suivi de tickets partagés. Ils ne partagent pas l'état de session en direct, mais ils lisent la même base de connaissances.
Q : Puis-je personnaliser les workers ? Oui. Le Worker Studio (dans le CRM) te permet de modifier le system prompt, les skills et le comportement de chaque worker.
Q : Comment fonctionne la facturation ? Tu utilises ton propre abonnement Claude Pro ou Max. Arc OS n'ajoute pas de frais pour l'utilisation de Claude — tu paies Anthropic directement. Arc OS facture des frais de plateforme pour le tableau de bord et l'outillage.
Q : Et si je veux un type de worker qui n'est pas listé ? Crée un worker personnalisé dans le Worker Studio. Définis son rôle, ses permissions, et injecte les skills dont tu as besoin.
Tes données & ta vie privée
Arc OS est conçu pour garder tes données sous ton contrôle.
Exporter tes données (RGPD Art. 20)
Tu peux télécharger à tout moment un export JSON complet de toutes les données de ton compte :
- Va dans Settings → Security → Download my data
- Un fichier JSON est généré et téléchargé immédiatement
L'export inclut les informations de ton compte, tes projets, l'historique de chat, les tickets, les pages wiki, les skills et les logs d'activité. Limité à 3 exports par 24 heures.
Supprimer ton compte (RGPD Art. 17)
Tu peux supprimer définitivement ton compte à tout moment :
- Va dans Settings → Security → Delete account
- Confirme la suppression
Cela efface immédiatement et définitivement toutes tes données dans toutes les tables — projets, historique de chat, skills, entrées du vault, logs d'activité et ta ligne de compte. Cette action est irréversible.
Ce que nous ne faisons pas
- Nous n'utilisons pas ton code, tes prompts ou les réponses IA pour entraîner des modèles
- Nous n'intégrons pas de trackers publicitaires ni de SDK d'analytics
- Nous ne posons pas de cookies HTTP — tout l'état de session est dans
localStorage - Nous ne partageons pas tes données avec des tiers au-delà de ce qui est nécessaire au fonctionnement du service (CDN Cloudflare, inférence IA Anthropic, fournisseurs OAuth)
Pour la politique complète, voir la Politique de confidentialité.