Modifier le profil

Objectif : modifier une valeur dans le profil partagé et la propager vers chaque environnement que vous avez installé.

PrérequisCopy Anchor Link

• La CLI apothem sur votre PATH (ou la forme autonome : préfixez par PYTHONPATH="$HOME/.apothem/src" et exécutez python -m apothem, ou utilisez npx @ahmed-g-gad/apothem).
• Un profil à ~/.config/apothem/profile.yaml. Créez-en un avec apothem profile init s'il est absent.

La structure du profilCopy Anchor Link

Le profil est un unique document YAML. Ses clés de premier niveau :

• identity (requis) — name, plus role, email, website, github en option.
• preferences — language, style (concise / verbose / balanced), formatter, test_framework.
• rules — une liste de chaînes de règles supplémentaires partagées avec les environnements capables.
• seriousness — l'une des valeurs EXPLORING, PERSONAL_USE, SHARED, PUBLIC_LAUNCH.
• enforcement — bascules opt-in (sprints, agent_teams, multitasking, continuous_execution, learning_loop), chaque drapeau désactivé par défaut.
• harnesses — surcharges par environnement indexées par identifiant d'environnement.
• exclude_harnesses — identifiants d'environnements ignorés par les commandes en lot (--harness all).
• mcp_servers — définitions de serveurs MCP indexées par nom de serveur.
• agent_mcp_servers — pour chaque nom d'auxiliaire, les serveurs MCP que cet auxiliaire peut appeler (voir Donner à un auxiliaire l'accès aux serveurs MCP). Vide par défaut ; aucun auxiliaire n'atteint donc un outil MCP.
• workspace — l'emplacement où Apothem conserve son répertoire de travail partagé (directory_name, scope).
• schema_version — version facultative du schéma de profil ; un profil qui en est dépourvu est lu comme version 1.

Chaque champ est répertorié dans Champs du profil.

ÉtapesCopy Anchor Link

1. Inspectez le profil actuel :

   Copy Text

   apothem profile show

2. Modifiez-le. Ouvrez-le dans l'éditeur de votre système :

   Copy Text

   apothem profile edit

   Ou définissez une seule clé pointée depuis la ligne de commande. La valeur est stockée littéralement (sauf les entrées true/false et [..]/{..} explicites, qui sont analysées) et le profil est validé par rapport au schéma avant l'écriture — une affectation invalide est refusée et le profil sur disque reste inchangé :

   Copy Text

   apothem profile set seriousness SHARED
   apothem profile set identity.name "Ada Lovelace"

3. Re-matérialisez les environnements pour que la modification atteigne leur configuration native. Pour un environnement au niveau utilisateur :

   Copy Text

   apothem update --harness claude-code

   Pour un environnement au niveau projet, passez la racine du projet ; utilisez all pour rafraîchir chaque environnement installé :

   Copy Text

   apothem update --harness cursor --project /path/to/project
   apothem update --harness all --project /path/to/project

VérifierCopy Anchor Link

apothem profile show
apothem verify --harness all

profile show reflète votre modification.

apothem verify --harness all vérifie chaque environnement enregistré, à l'exception de ceux que liste exclude_harnesses du profil ; la commande se termine donc avec un code non nul, sauf si tous les autres sont installés. Les environnements à portée de projet exigent aussi --project PATH ; sans cette option, le lot s'arrête avec une erreur project.required. Pour ne vérifier que l'environnement que vous avez mis à jour, exécutez la même commande avec le nom de cet environnement :

apothem verify --harness <name>

Pour une vue d'ensemble du système qui tolère les environnements que vous n'avez pas installés, exécutez apothem doctor.

ConnexesCopy Anchor Link

• Ajouter un environnement pour placer un nouvel environnement sous le contrôle du profil avant de re-matérialiser.
• Mise à jour couvre la mise à niveau du moteur en parallèle de l'étape de re-matérialisation.