# CLI d'agent de code

Connectez un ordinateur, authentifiez les fournisseurs Pi, enregistrez les repositories et gerez l'hote BernOps.

Utilisez la CLI BernOps pour connecter cet ordinateur à l'application et exécuter des sessions de codage appartenant au créateur avec l'agent Pi intégré. Un hôte personnel d'agent de code est distinct d'un worker d'exécution d'espace de travail.

**Version courte**

Installez le bootstrap privé approuvé, puis lancez `bernops setup` depuis le repository à autoriser. Choisissez **2 (agent de code)** ou **4 (les deux)**. Le menu propose par défaut **1 (authentification plateforme uniquement)**, qui ne connecte aucun hôte.


**Besoin d'un worker plutôt ?**

Pour la capacité d'exécution Playwright et SDK natif, suivez [Connecter un worker](/fr/docs/workers-and-pool#worker-setup). Lancez `bernops setup` et choisissez **3 (worker d'automatisation)**, ou **4 (les deux)** pour configurer indépendamment hôte et worker. L'assistant gère la connexion plateforme partagée et l'approbation distincte du worker pour un espace. Le choix worker seul n'installe pas Pi et ne configure aucun fournisseur. `bernops auth login` ne fait que l'authentification et n'inscrit jamais d'hôte ni de worker.


## Démarrage rapide

La distribution reste privée : aucune URL de téléchargement publique, commande `curl | sh` ou installation npm n'est prise en charge. Obtenez l'archive complète du bootstrap approuvé auprès de votre opérateur et authentifiez sa somme de contrôle et sa provenance par un canal de confiance **avant extraction ou exécution**. Une somme de contrôle fournie avec un téléchargement non fiable ne suffit pas.

Après obtention et extraction approuvées, lancez l'installateur inclus avec votre utilisateur habituel, sans sudo. Remplacez le chemin d'exemple par celui de l'extraction vérifiée :

```bash
/absolute/verified/bootstrap-linux-x64/install.sh
export PATH="$HOME/.local/bin:$PATH"
bernops --version
```

Le bootstrap inclut Node 22.19.0 épinglé ; les utilisateurs finaux n'installent ni Node ni NVM et ne compilent pas la CLI. Le périmètre visé est Ubuntu/Debian x86-64 ; la qualification sur OS neuf avec ou sans bureau et en production cloud reste incomplète. L'opérateur doit configurer des versions de composants signées et approuvées. L'authentification seule ne nécessite ni Pi, ni Docker, ni moteur worker.

Depuis le repository Git à autoriser, lancez :

```bash
bernops setup
```

1. Choisissez **2 (agent de code)** ou **4 (les deux)**, pas l'authentification seule proposée par défaut. Sélectionnez la racine Git courante affichée ou saisissez une autre racine Git absolue. Le nom du repository est généré automatiquement, sans invite de nommage. La détection seule n'accorde aucun accès.
2. Effectuez la connexion plateforme, puis approuvez séparément l'hôte personnel lié. Si les deux composants sont sélectionnés, l'approbation du worker pour son espace est encore une autorisation indépendante.
3. L'assistant installe le composant agent privé signé, gère la connexion OpenAI Codex si les identifiants locaux sont absents, puis configure l'accès au repository et le service utilisateur. Les identifiants fournisseur compatibles sont réutilisés. Aucune commande préalable `auth login`, de connexion fournisseur ou de mise à niveau n'est nécessaire.
4. Attendez que les composants sélectionnés indiquent `ready`. L'agent doit disposer d'un repository accessible, d'identifiants fournisseur, d'un service utilisateur actif et d'une connexion hôte authentifiée observée, pas seulement d'un processus actif. Aucune requête modèle facturable ne valide le fournisseur.

Pour le développement depuis le checkout BernOps approuvé avec la pile locale :

```bash
./dev.sh install-cli
bernops setup --local
```

`./dev.sh install-cli` prépare les versions locales signées et active le bootstrap privé à cible locale sans redémarrer la pile. Il peut utiliser un Node 22.19.0 déjà installé via NVM, mais n'installe jamais NVM ni Node. La préparation des versions exige des prérequis de build développeur ; ce n'est pas le parcours d'installation utilisateur. Le backend local doit fonctionner avec son catalogue de versions configuré.

L’assistant et `auth login` ciblent le **cloud** par défaut, indépendamment du build, de l’identité enregistrée ou du journal. Utilisez `bernops setup --local` (ou `--target local`) en développement local ; utilisez `--target cloud` pour choisir explicitement le cloud. Un conflit de cible échoue au lieu de migrer les identités ; consulter ces docs localement ne choisit pas la cible de la CLI. Un serveur d’inférence sur localhost ne choisit pas un backend BernOps local.

Pour choisir explicitement plutôt que via le menu interactif :

```bash
bernops setup --components agent --repo /home/user/code/project
```

`--repo <directory>` sélectionne une racine Git absolue sans option de nommage. Sans TTY, y compris en mode JSON, `--components` est obligatoire : `auth`, `agent`, `worker` ou `agent,worker`. Ne combinez pas `auth` avec les autres noms ; l'authentification est déjà partagée. Les options explicites ne suppriment ni les approbations ni les interactions fournisseur.

Pi est le moteur intégré. Ne fournissez pas `--runtime`, `--backend` ou `--app` : ce ne sont pas des options publiques d'onboarding.

Pour les statistiques personnelles de jetons, la répartition par modèle et la carte thermique quotidienne, consultez [Statistiques d’utilisation](/fr/docs/agent-tools#usage-analytics).

## Livraison pilotée par agent MVP (candidat restreint)

**La qualification n'autorise pas le déploiement**

La livraison reste désactivée par défaut et exige un hôte compatible explicitement approuvé. Les contrôles de composants et worker seul sans fournisseur ne qualifient ni l'activation agent/both ni la livraison réelle par modèle. Les essais fournisseur, le routage/coût mesuré des modèles et les permissions réelles du remote restent non qualifiés lorsqu'ils sont ignorés. L'acceptation indépendante de la fonctionnalité, l'acceptation humaine, la fusion et le déploiement sont des étapes distinctes. Ce guide n'active rien et ne garantit pas une correction sans supervision.


1. Dans **Agents → configurations** du projet, sélectionnez les révisions privées au créateur pour l'implémentation et la revue. Examinez fournisseur/modèle, réflexion, instructions, outils autorisés et limites. La livraison gérée autorise 1–128 appels outils et 5–240 minutes murales par tentative ; les membres parallèles comptent individuellement, les attentes comptent dans le temps et Task/TaskBatch sont désactivés. Ce n'est ni un plafond global de dépenses ni une preuve d'arrêt du processus.
2. Ouvrez **Flux de travail → Nouvelle exécution** (onglet **Configurer**), sélectionnez label, hôte, repository, référence cible et configurations, puis prévisualisez le snapshot complet. Examinez exclusions, prédécesseurs externes, chemins bloquants et ordre d'exécution. Le travail doit être Todo non réclamé, pas Backlog. Le graphe ne peut pas déduire les dépendances sémantiques manquantes : vérifiez les déclarations avant de les confirmer, même sans dépendance affichée. Résolvez les blocages avant Start ; toute modification du périmètre ou des révisions exige une nouvelle prévisualisation et approbation.
3. Start fige le périmètre et les rôles approuvés. Son reçu signifie admission, pas exécution réussie. Réconciliez un Start incertain par l'action explicite de même requête, jamais une nouvelle clé. L'implémentation réclame un item, vérifie et pousse la branche de livraison avant In Review. Une nouvelle session de revue/réparation récupère la branche la plus récente, effectue les réparations substantielles dans le périmètre, vérifie et pousse avant Done. Une absence réelle de changement exige des preuves, pas un commit inventé. Les dépendants attendent Done, les reçus requis et l'arrêt positif du prédécesseur ; déplacer une carte ne prouve pas sa disponibilité.
4. Un worktree/une branche conservés et une PR cumulative servent le run. La revue finale vérifie le dernier head cumulatif, réparations du reviewer comprises. Des corrections finales conséquentes exigent une nouvelle vérification limitée aux contrôles sur le head exact, pas une autre boucle de réparation. Le transfert final demande une revue humaine : Done, awaiting human et completed ne signifient pas fusionné ou déployé. L'humain décide de la fusion séparément du déploiement.

Le détail du workflow affiche état/révision/génération canoniques, libération du writer, raison d'attention, prochain acteur, sessions, branche/PR et historique des contrôles. Fermer le navigateur n'annule pas le run backend ; actualisez au retour. Verdicts du registre, heads et références de contrôles sont des affirmations de l'agent : examinez les artefacts et effets réels remote/board. Le modèle demandé est distinct du modèle observé. L'usage est paginé ; tokens ou coûts absents sont **inconnus**, pas nuls. Les coûts catalogue sont des estimations, pas des factures fournisseur ni un budget global du run.

### Tableau de bord des flux de travail et exemples en lecture seule

Ouvrez **Flux de travail** directement dans la barre latérale du projet, sous Agents. Le lien conserve le projet sélectionné et reste actif sur les pages de détail. L’onglet **Flux de travail → Vue d’ensemble** sépare la supervision du lancement. Filtrez les exécutions privées par Actives, Intervention requise, En attente de revue ou Terminées, puis recherchez les titres figés des éléments, la branche ou l’identifiant. Le titre provient du premier élément dans l’ordre d’exécution, pas d’un nom de flux enregistré séparément. La dernière actualisation réussie correspond à la lecture serveur, pas à la dernière activité de l’agent ; un échec de lecture conserve un avertissement de données obsolètes.

Ouvrez une exécution pour inspecter son résultat et la prochaine action. L’**Historique d’exécution** regroupe implémentation et revue sous chaque titre de tâche figé, avec une revue finale cumulative séparée. Les tentatives précédentes restent dans leur étape ; l’étape active ou échouée s’ouvre pour inspection. **Exigences figées et dépendances** conserve le périmètre approuvé sans encombrer l’historique. Une exécution en attente humaine propose **Examiner la pull request**, pas une étape finale encore active ; elle n’est pas fusionnée.

Chaque étape sépare **Rapport**, **Modèle et utilisation** et **Détails techniques**. Ouvrez directement sa conversation ou sa PR. Les références de contrôle sont des déclarations de l’agent dépliables, jamais une certification indépendante. **Tableau : Terminée** provient d’une lecture actuelle distincte du tableau, pas d’un badge « Déclaré prêt » ; une lecture échouée ou indisponible reste inconnue. La libération de l’écriture décrit l’allocation actuelle au niveau du flux, pas une preuve par étape déduite de son état prêt. Les couleurs sémantiques renforcent les textes et icônes : vert pour Terminée dans le tableau ou une libération confirmée, bleu pour l’exécution active, ambre pour l’attente/intervention et rouge pour les étapes échouées/bloquées. L’état prêt déclaré par l’agent reste neutre.

L’utilisation n’est chargée qu’à l’ouverture de **Modèle et utilisation**. L’**Utilisation enregistrée** désigne explicitement les observations conservées sur la page actuelle, et non les totaux de l’étape ou du flux. Les tokens et coûts manquants restent inconnus, jamais nuls. Les requêtes principales et enfants conservent leur attribution distincte ; les modèles observés multiples restent visibles. Le modèle configuré/demandé et les identifiants/commits copiables figurent dans **Détails techniques**. Les coûts estimés du catalogue, même nuls, ne sont ni des factures ni une preuve d’exécution gratuite. Retrouvez ce guide avec `bernops docs search "historique d’exécution"` et `bernops docs get coding-agent-cli#workflow-supervision`.

Révision/génération et historique des contrôles restent sous **Diagnostics avancés et historique des commandes**. Les champs de récupération apparaissent lorsqu’elle est pertinente ; les règles explicites de preuve et de revérification ci-dessous restent applicables.

L’onglet **Exemples** propose six scénarios en lecture seule : prête à démarrer, périmètre bloqué, en cours, intervention requise, en pause et en attente de revue humaine. Chacun indique **Exemple de démonstration — aucun agent exécuté**. Ce sont uniquement des données de présentation : aucun remplissage du compte, création de tâches, connexion d’hôte, appel fournisseur, opération Git ou commande de cycle de vie. Les exigences proposées de validation, formulaire accessible et contrôles navigateur décrivent un petit laboratoire dans un dépôt jetable, pas un résultat réel. Un essai réel exige toujours un hôte compatible approuvé, un fournisseur et un budget autorisés ainsi qu’un remote jetable avec interdictions externes de push/fusion. Les exemples n’activent pas la livraison et ne remplacent pas l’acceptation authentique.

### Activation locale du runtime de livraison (opérateurs)

Retrouvez cette section via `bernops docs search BERNOPS_AGENT_DELIVERY_ENABLED` ou `bernops docs get coding-agent-cli#delivery-local-opt-in`.

Ce commutateur développeur restreint est **désactivé par défaut** : ce n'est ni un déploiement en production ni une preuve de livraison réussie. Obtenez une autorisation propre à la tâche pour la machine hors production et ses changements CLI/services. Conservez la [configuration locale](#quick-start), les identifiants natifs, le fournisseur explicitement choisi et les restrictions remote ; un worktree séparé n'est pas un sandbox.

Sans run de livraison actif et avec un host inactif, préservez `backend/.env.local` puis ajoutez `BERNOPS_DELIVERY_ENABLED=true` sans remplacer ses autres paramètres. Le backend exige `BERNOPS_ENVIRONMENT=development` et des URL HTTP Supabase API/publique locales sur le port `54421` ; les autres cibles empêchent le démarrage. Utilisez l'override Compose frontend-dev via `dev.sh`, pas une recréation backend avec le fichier de base seul :

```bash
./dev.sh install-cli
./dev.sh up
bernops service upgrade
BERNOPS_AGENT_DELIVERY_ENABLED=true bernops service install
```

Ces commandes remplacent la CLI locale approuvée, actualisent la stack sans reset, sélectionnent le volume de releases signées courant et redémarrent l'agent inactif. L'authentification locale et l'approbation du host doivent être valides ; sinon utilisez `bernops setup --local`, jamais setup sans option pour un test local. L'activation du host exige Linux, le vrai runtime Pi et le backend exact `http://127.0.0.1:3410`. Le choix persiste lors des opérations de service prises en charge ; une variable shell ambiante sur status, restart ou upgrade ordinaire ne le change pas. L'initialisation réelle doit fournir préparation, exécution et récupération avant d'annoncer `delivery_sessions_v1`, `delivery_preparation_v1` et `delivery_recovery_v1`. Ne modifiez pas les lignes de capacités pour contourner l'admission.

Inspectez le host connecté, actualisez le preview canonique dans l'UI et approuvez Start une seule fois. Un reçu `201` prouve uniquement l'admission. Si l'exécution bloque, conservez le run et l'échec exact ; ne substituez pas une conversation et n'avancez pas les cartes manuellement.

Pour désactiver après la fin de tout travail géré, lancez `BERNOPS_AGENT_DELIVERY_ENABLED=false bernops service install`, mettez le commutateur backend à `false` puis lancez `./dev.sh up` sans reset. Désactivez avant un rollback vers une release antérieure à ce commutateur. Changer la configuration n'est ni Cancel ni une preuve positive d'arrêt du writer ; utilisez la [récupération manuelle](#delivery-recovery) pour le travail actif.

### Pause, Cancel et Resume manuel

- **Pause** draine/bloque la progression ; ce n'est ni un rollback ni un arrêt instantané. Un transfert déjà engagé peut se terminer. Une Pause avant préparation peut être rejetée sans écriture ; relisez le run.
- **Cancel** demande abandon/fermeture, pas suppression des effets poussés. `cancel_requested`, `paused` ou `manual_attention` seuls ne prouvent jamais l'arrêt de l'ancien writer ou la libération de réservation.
- **Resume** exige réconciliation manuelle, preuve positive de libération puis admission explicite ultérieure. Inspectez d'abord anciens processus/journaux et effets push, PR et board. Saisissez le head SHA observé de 40 caractères minuscules et des statuts honnêtes ; inconnu ne signifie pas « none ». Les effets réconciliés exigent des références `push:`, `pr:` ou `board:` correspondantes (12 maximum). Conservez l'identité d'attestation/récupération en revérifiant explicitement la preuve en attente avec l'état serveur actualisé. Une réponse en attente ne signifie pas exécution reprise.
- Si la réponse d'un contrôle est incertaine, utilisez seulement la réconciliation de la requête originale exacte. Ne remplacez pas les identités et ne relancez pas automatiquement. Après un rejet définitif de récupération, enquêtez avant d'utiliser délibérément l'action de nouvelle attestation proposée. Preuve manquante, révocation ou ancien writer incertain exigent l'opérateur, pas un second run.

Ne supprimez jamais verrous, journaux, réservations conservées ou reçus, ne dépossédez pas un autre propriétaire et ne déplacez pas de cartes pour contourner l'exclusion du writer. Les worktrees ne sont **pas des sandboxes** : outils et enfants héritent des permissions fichiers/réseau et de la politique de privilèges de l'utilisateur hôte. BernOps ne fournit pas d'isolation d'exécution et n'accorde pas sudo. L'opérateur doit imposer les identifiants externes et l'interdiction de push/fusion/auto-merge sur la cible protégée ; les prompts ne remplacent pas la protection de branche.

Le redémarrage après retour de PR, la fusion/récupération/relecture automatiques et les writers de livraison parallèles sont différés. Conservez échecs et interruptions avec candidat/head exacts et références sûres, sans secrets. Les opérateurs du repository suivent `docs/agent-led-delivery-runbook.md` et `docs/test-vm-workflow.md` : tests d'intégration et CLI installée dans le guest approuvé exclusivement réservé, jamais sur l'installation stable/source ou en production. La qualification sans fournisseur marque les branches modèle non exécutées SKIPPED, pas PASS, sans retirer les exigences fournisseur du produit pour les sessions agent.

## Code et sources récupérées dans le chat

Dans les versions compatibles, le code et les différences utilisent les contrôles Code Block ; les outils, le raisonnement et les sous-agents utilisent Trace. La copie conserve le texte original, avec un affichage en texte brut pour les syntaxes non prises en charge. Les résumés des fichiers modifiés proposent une vue par dossiers facultative sans modifier les différences ni les avis d’omission.

Les outils web réussis peuvent afficher des **sources récupérées** bornées : liens sûrs, extraits, date de récupération et avis d’omission. La date de récupération n’est pas la date de publication. Les aperçus décrivent les liens explicites de la réponse ; ni les sources récupérées ni les aperçus ne prouvent qu’une source étaye une affirmation. Aucune citation par affirmation n’est déduite.

Déployer la migration des métadonnées avant le backend compatible. Les métadonnées sont négociées : les anciens hôtes et les onglets déjà ouverts continuent sans elles ; actualiser pour activer le nouvel affichage. Les nouveaux hôtes omettent les métadonnées pour les backends incompatibles. Si un backend est rétrogradé après la journalisation d’événements enrichis, ceux-ci restent en attente du retour de la compatibilité ; ils ne sont jamais réécrits sous une identité existante. Cette documentation ne prouve pas un déploiement en production et n’autorise pas la mise à niveau d’une installation protégée.

## Sortie lisible et JSON

Un terminal interactif affiche des résultats lisibles et concis. Les commandes redirigées conservent le format JSON compact et stable pour les scripts. Utilisez l'option globale `--json` avant la commande pour forcer ce format, ou `--debug` pour ajouter des détails techniques expurgés à la sortie interactive :

```bash
bernops --json workspace list
bernops --debug status
```

Les options globales de sortie doivent précéder la commande. La combinaison de `--json` et `--debug` produit uniquement l'enveloppe JSON normale, sans flux supplémentaire susceptible de casser l'analyse. Le mode debug n'ajoute jamais de jetons OAuth, de clés API de projet, de secrets de jumelage, de corps de requête ou d'erreurs brutes inconnues. Les vues humaine et debug masquent les jetons de bail renvoyés ; les automatisations de réclamation qui en ont besoin doivent utiliser `--json`. `bernops service logs` reste un flux de journaux non formaté.

## Connexion utilisateur et stockage des identifiants

```bash
bernops auth login
bernops auth login --target local
bernops auth status
```

Ce sont des **alternatives d'authentification seule**, pas des prérequis de configuration. `bernops auth login` crée ou réutilise uniquement la session utilisateur plateforme : cette commande n'inscrit pas d'hôte, ne connecte pas Codex, n'enregistre pas de repository et ne démarre ni service ni worker. `bernops setup --components auth` offre le même choix léger via l'assistant ; fournissez `--target local` ou `--target cloud` pour choisir explicitement une cible d'authentification.

Linux Secret Service est le stockage par défaut des identifiants plateforme **en local comme dans le cloud**. Il exige `secret-tool`, `gdbus` et un Secret Service déverrouillé dans la session D-Bus de l'utilisateur réel. Les jetons d'accès restent en mémoire. Aucun repli automatique en clair n'existe. Pour une nouvelle identité, `--credential-store file` ou le choix explicite `BERNOPS_AUTH_STORE=file` accepte un fichier d'identifiants de renouvellement réservé au propriétaire mais **non chiffré**. Les identités enregistrées gardent leur stockage ; cette option ne le migre pas. Réparez un stockage natif verrouillé, refusé ou indisponible plutôt que de le dégrader.

Les commandes d'espace de travail, projet, job, file, exécution et découverte utilisent cette session OAuth. `bernops app` reste explicitement authentifié par une clé API de projet ; aucun principal ne se rabat silencieusement sur l'autre.

## Connexion au fournisseur

Le choix agent dans `bernops setup` gère déjà la connexion OpenAI Codex si nécessaire via l'infrastructure fournisseur Pi épinglée. L'onboarding unifié ne prend actuellement en charge que `openai-codex` ; l'authentification seule et le worker seul ne configurent aucun fournisseur. Pour inspecter ou renouveler délibérément la connexion fournisseur d'un agent installé :

```bash
bernops provider login openai-codex
bernops provider status
```

Suivez les instructions de connexion affichées par le fournisseur. `--no-browser` ne garantit pas une connexion fournisseur non interactive ; sans TTY, le résultat peut être `provider_login_interactive_required`. Les identifiants restent dans `~/.pi/agent/auth.json` et ne sont jamais envoyés au backend BernOps.

```bash
bernops provider logout openai-codex
```

Pour votre propre infrastructure d’inférence, consultez [Fournisseurs compatibles OpenAI](/fr/docs/openai-compatible-providers) : connectez Ollama local, Strata ou une autre API compatible avec une authentification Bearer explicite ou sans authentification, puis sélectionnez le modèle manuellement. Le guide inclut Strata local, des exemples distants authentifiés, un [parcours d’hôte avec uniquement un fournisseur personnalisé sans Codex](/fr/docs/openai-compatible-providers#without-codex), la sélection dans l’interface et le dépannage. Ces commandes exigent une version installée compatible et ne modifient pas la politique Codex de l’assistant standard.

## Enregistrer les repositories

L'assistant peut enregistrer un repository avec votre accord. Seuls les checkouts explicitement enregistrés peuvent être sélectionnés dans BernOps. Pour ajouter une autre racine Git ensuite, lancez depuis cette racine :

```bash
bernops repo add "$PWD"
bernops repo list
```

Les deux commandes d'enregistrement nomment automatiquement les repositories à partir du dernier segment du chemin du repository Git `origin`. Les origines HTTPS (`https://github.com/owner/project.git`), URL SSH (`ssh://git@github.com/owner/project.git`) et de type scp (`git@github.com:owner/project.git`) donnent toutes `project`, après suppression du suffixe `.git`. Si aucun nom d'origine exploitable n'est disponible, le nom du dossier canonique du checkout est utilisé. Aucune invite de nommage ni option de personnalisation d'alias ou de libellé n'est proposée.

L'option facultative `bernops repo add <directory> --remote owner/name` fournit uniquement les métadonnées distantes sûres existantes ; elle ne remplace pas le nom généré. Les champs du protocole et du stockage `alias` et `display_name` restent inchangés. L'application reçoit les métadonnées sûres du repository et sa disponibilité, pas le chemin canonique de l'hôte. Conserver l'accès existant n'ajoute aucun accès au dossier courant ni au dossier personnel. Sans repository enregistré disponible, l'agent signale qu'une intervention est nécessaire, pas un état prêt. L'enregistrement n'est pas un bac à sable système : l'agent personnel hérite des permissions de votre utilisateur.

## Service en arrière-plan et usage sans bureau

La configuration unifiée de l'agent exige un utilisateur habituel non root et un gestionnaire systemd utilisateur fonctionnel. Elle installe le service s'il est absent, le démarre s'il est arrêté et préserve un service actif vérifié. L'absence de gestionnaire ou du linger requis nécessite une intervention, **pas un repli au premier plan**. Demandez à l'administrateur de vérifier la configuration D-Bus/session ; l'assistant n'installe jamais de paquets système et ne modifie aucun paramètre privilégié.

La préparation du service agent exécute encore `npm ci` avec npm inclus et exige l'accès au registre de dépendances. La livraison d'une archive signée ne permet pas d'installer le service hors ligne.

```bash
bernops service status
bernops service logs --lines 200
```

Pour des approbations distantes et un agent qui doit rester disponible après fermeture de session :

```bash
bernops setup --components agent --repo /home/user/code/project \
  --no-browser --headless
```

`--no-browser` supprime l'ouverture du navigateur, pas le consentement. Laissez la CLI interroger le backend, ouvrez chaque URL affichée sur un autre appareil, comparez le code humain et le compte connecté, puis vérifiez l'empreinte de l'hôte avant d'approuver. L'approbation plateforme utilise un relais Authorization Code + PKCE, pas un flux OAuth de code d'appareil. Gardez les URL et codes d'approbation privés.

`--headless` est réservé à l'agent et exige que `loginctl show-user "$UID" --property=Linger --value` indique `yes`. Un administrateur peut examiner l'activation du linger pour cet utilisateur ; l'assistant ne l'active jamais. Headless n'implique pas le stockage fichier : utilisez le stockage natif disponible, ou ajoutez délibérément `--credential-store file` pour une nouvelle identité si vous acceptez un stockage non chiffré.

La commande avancée `bernops --foreground` reste disponible pour exécuter délibérément un agent installé au premier plan. Ce n'est pas le parcours de configuration unifiée et elle ne satisfait pas ses contrôles de disponibilité du service en arrière-plan.

## Mettre à niveau

Relancez `bernops setup` avec la même cible et les mêmes choix pour reprendre ou vérifier la disponibilité. Désélectionner un composant ne le désinstalle jamais. L'assistant interactif demande confirmation avant de sélectionner une nouvelle version signée de l'agent ou d'actualiser un service éligible sans travail en cours qui ne prend pas en charge le statut de connexion. En cas de refus, de travail en cours ou d'échec de vérification, l'état est préservé et une intervention est signalée comme nécessaire ; aucune mise à niveau manuelle n'est requise dans le parcours interactif normal.

Pour des opérations délibérées sur le cycle de vie du service d'un agent installé :

```bash
bernops service upgrade
bernops service rollback
```

Ces opérations redémarrent délibérément le service avec des versions vérifiées et un état de retour arrière conservé. Elles ne mettent pas à jour le bootstrap et ne migrent ni comptes, ni cibles, ni origines. Ne supprimez et ne modifiez pas les reçus de version ni `installation.json` pour forcer une mise à niveau.

Pour supprimer délibérément seulement le service, puis laisser la configuration agent le réinstaller :

```bash
bernops service uninstall
bernops setup --components agent
```

La désinstallation du service conserve l'identité hôte, les repositories, les identifiants Pi, les versions et les données de session. L'installateur privé du bootstrap ne se met pas à jour lui-même et refuse une commande existante ; demandez à l'opérateur de vérifier tout remplacement. Depuis un checkout de développement, `./dev.sh install-cli` peut activer un bootstrap local vérifié en conservant les éléments de récupération.

## Raccourcis de commandes

Choisissez la commande adaptée à votre intention ; cette liste n'est pas une séquence à exécuter. Logout et disconnect sont des nettoyages délibérés, pas des prérequis de configuration.

```bash
bernops setup
bernops setup --target local
bernops setup --local
bernops setup --components auth
bernops setup --components agent,worker
bernops auth login
bernops auth login --target local
bernops auth login --credential-store file
bernops auth status
bernops auth logout
bernops auth logout --local-only
bernops logout
bernops disconnect --everything
bernops status
bernops doctor
bernops provider login openai-codex
bernops provider status
bernops repo add <directory>
bernops repo list
bernops service status
bernops service restart
bernops credential rotate
```

Recherchez la documentation publique actuelle sans connexion, configuration de fournisseur ni installation du composant d'agent de code :

```bash
bernops docs search "worker setup"
bernops --json docs search "work item claims" --limit 10
bernops docs search "variables" --locale fr
bernops docs get coding-agent-cli#command-reference
```

La CLI récupère un index compact depuis `https://bernops.com` en HTTPS et renvoie les liens des sections pertinentes avec de courts extraits. Elle ne télécharge pas toutes les pages et ne transmet pas votre recherche à un fournisseur de recherche. Les docs publiques décrivent leur révision actuelle ; consultez l'aide `--help` installée pour les commandes prises en charge par une ancienne CLI.

Pour la découverte d'opérations, les lectures compactes gérées, les ETags sûrs et la planification roadmap atomique sur les versions compatibles, consultez [Utilisation efficace des outils agent](/fr/docs/agent-tools). Les références publiques ne garantissent pas que ces opérations sont disponibles dans votre backend déployé ou hôte installé.

## Choisir la bonne déconnexion

- `bernops auth logout` révoque la session CLI distante de cette installation, puis efface l'état OAuth local.
- `bernops auth logout --local-only` efface uniquement l'identifiant OAuth local.
- `bernops logout` supprime de façon destructive l'identité hôte locale, sa file d'envoi et son service, pas l'autorisation hôte distante. Ce n'est pas une réparation de verrou ou de réinitialisation.
- `bernops provider logout` supprime uniquement l'identifiant du fournisseur sélectionné.
- `bernops disconnect --everything` nettoie localement l'authentification, l'hôte et le service, ainsi que les identifiants du seul fournisseur par défaut OpenAI Codex, pas ceux de tous les fournisseurs enregistrés. Il ne supprime ni ne désinstalle les workers et n'effectue aucune révocation distante ; le résultat indique `remote_revoked:false`.

La déconnexion plateforme ne supprime pas les accès hôte, fournisseur ou worker. La déconnexion du navigateur, la révocation globale du client, la révocation serveur de l'hôte, la révocation d'une clé API de projet et la suppression d'une session restent distinctes. Les commandes de lecture/nettoyage comme `status`, `doctor`, `service stop|logs|status|uninstall`, `repo list` et `provider status|logout` peuvent utiliser le moteur installé signé et vérifié sans connexion plateforme ni accès aux versions en ligne. Ce n'est pas un contournement pour installer ou exécuter hors ligne.

## Dépannage

- `backend_unreachable` : depuis le même espace réseau, vérifiez `http://127.0.0.1:3410/health` avec `--target local`.
- Aucun navigateur : ajoutez `--no-browser` et utilisez l'URL de vérification affichée pendant que la CLI continue d'interroger le backend.
- Coffre natif indisponible ou verrouillé : restaurez le trousseau ou la session. Le stockage fichier exige un accord explicite pour une nouvelle identité et ne migre pas une session native enregistrée.
- Compte incompatible : terminez avec le compte propriétaire de l'hôte proposé, ou annulez et créez une nouvelle transaction. BernOps ne transfère jamais l'hôte.
- Aucun modèle : lancez `bernops provider status`, puis connectez le fournisseur requis.
- Aucun gestionnaire systemd utilisateur ou linger headless absent : demandez à l'administrateur de fournir les prérequis, puis relancez l'assistant. Aucun repli automatique au premier plan n'existe.
- Base réinitialisée ou ancien hôte local confirmé : relancez `bernops setup` avec la même cible et les mêmes choix. Examinez **Reconnect this PC?** si proposé. Un accord explicite peut archiver les anciennes sessions locales et obtenir une nouvelle approbation hôte tout en conservant la connexion fournisseur et l'accès aux repositories. Ne supprimez pas l'état et n'utilisez pas logout comme réparation universelle.
- `component_release_trust_unconfigured` ou `component_releases_not_configured` : demandez à l'opérateur un bootstrap approuvé et un catalogue signé. Ne contournez pas les signatures et n'installez pas de substituts publics.
- Configuration interrompue : arrêtez les opérations concurrentes, confirmez la fin du processus initial, puis reprenez les mêmes choix. Les verrous sécurisés peuvent récupérer un propriétaire obsolète vérifié ; un verrou actif ou dangereux exige une investigation, pas une suppression aveugle.

Le résumé indique `ready`, `needs_attention`, `failed` ou `not_selected` par composant. Le code de sortie 0 signifie que tous les composants sélectionnés sont prêts, 2 indique qu'une intervention est nécessaire et 1 un échec. Les composants terminés restent intacts si un autre échoue.

Consultez `docs/unified-onboarding.md` et `cli/README.md` dans le repository pour le contrat complet, les conditions de publication et les procédures de récupération opérateur.
