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 :

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 à :

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 :

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 :

  1. Charge ton wiki projet, tes skills et le ticket actif
  2. Ouvre une session Claude interactive dans ton terminal
  3. A un accès complet à ton système de fichiers local (Developer) ou en lecture seule (Consultant)
  4. Sauvegarde le contexte de session pour la prochaine fois

Pourquoi CLI-first ?

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 :

  1. Clique sur New Project
  2. Donne-lui un nom et connecte ton dépôt GitHub
  3. 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 :

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

  1. Va dans Billing → Standard Cloud
  2. Abonne-toi (voir le tarif actuel dans le tableau de bord)
  3. Clique sur Create Cloud Workspace — le conteneur est prêt en moins de 60 secondes
  4. Connecte Claude Code (ton abonnement Claude Pro)
  5. Connecte ta clé SSH GitHub
  6. 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


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 :

  1. Va dans Settings → Security → Download my data
  2. 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 :

  1. Va dans Settings → Security → Delete account
  2. 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

Pour la politique complète, voir la Politique de confidentialité.