Démarrage rapide

Voici le chemin rapide de zéro jusqu'à une configuration d'environnement vérifiée : installer, rédiger le profil partagé, matérialiser la configuration native d'un outil, la confirmer et effectuer votre première modification. Chaque commande est réelle et peut être copiée-collée, et chaque étape montre ce qu'affiche une exécution propre. L'installation elle-même se termine en moins de deux minutes ; éditer le profil est la seule partie qui prend autant de temps que vous le souhaitez.

À la fin, vous disposerez d'une configuration d'environnement fonctionnelle générée à partir d'un profil que vous avez rédigé — et vous connaîtrez l'unique commande qui répercute une modification du profil vers chaque outil.

Vous utiliserez Claude Code comme environnement d'exemple : c'est celui par défaut de l'installateur. Changez le nom de l'adaptateur à n'importe quelle étape pour cibler un autre outil ; la liste des environnements contient tous les noms pris en charge.

1. Installer Apothem

Apothem est distribué comme un runtime autonome : le moteur s'exécute directement depuis son arborescence de code source avec des dépendances intégrées. Une seule commande télécharge le code source, place le moteur et matérialise votre premier environnement :

curl -fsSL https://apothem.ahmedgad.com/install.sh | bash

irm https://apothem.ahmedgad.com/install.ps1 | iex

L'installateur requiert un Python 3.10+ système avec click et rich importables, ainsi que git pour la forme réseau. Il vérifie les prérequis, place le moteur dans ~/.apothem et affiche l'invocation exacte du moteur pour votre shell une fois terminé :

Apothem installed.
Run the engine with:

  apothem <command>

Le guide d'installation couvre les autres voies d'installation — le plugin Claude Code (/plugin marketplace add ahmed-g-gad/apothem puis /plugin install apothem@apothem) ; l'extension de la famille VS Code et les autres extensions natives des outils ; et la forme à la demande avec npx (npx @ahmed-g-gad/apothem <command>) — ainsi que les options de variables d'environnement.

2. Créer le profil partagé

apothem profile init écrit le plus petit profil valide possible dans ~/.config/apothem/profile.yaml. Passez --profile PATH lorsque vous conservez un profil spécifique à un projet ou à la CI ailleurs.

apothem profile init
apothem profile show --json

Le squelette utilise des données d'identité fictives de remplacement et peut être édité en toute sécurité avant d'installer toute sortie d'environnement. show --json le relit et signale le profil validé :

{
  "identity": {
    "name": "Example User",
    "email": "[email protected]",
    "github": "example-user"
  }
}

C'est aussi ici qu'une édition malformée apparaît : si le YAML n'est pas valide, show le signale à ce stade, avant qu'aucune configuration d'environnement ne soit écrite. Faites du profil le vôtre avec apothem profile edit (il l'ouvre dans votre éditeur) ou définissez une seule clé sur place :

apothem profile set identity.name "Your Name"

3. Installer les adaptateurs d'environnement

Matérialisez l'adaptateur de votre outil principal. Cela lit votre profil et écrit la configuration native de cet outil :

apothem install --harness claude-code

Installed claude-code.
Wrote: ~/.claude/settings.json

Les adaptateurs à portée projet écrivent à l'intérieur d'un projet plutôt que dans votre répertoire personnel, ils ont donc besoin d'un --project PATH. Prévisualisez n'importe quelle installation sans écrire de fichiers avec --dry-run :

apothem install --harness cursor --project . --dry-run
apothem install --harness cursor --project .

Installez l'ensemble complet appuyé par le registre d'un coup avec --harness all. Comme cette sélection écrit des fichiers à portée projet et à portée utilisateur, la commande affiche les cibles concrètes regroupées par emplacement et demande confirmation avant d'écrire en dehors de la racine du projet :

apothem install --harness all --project .

Consultez la liste complète des environnements pour tous les noms pris en charge, et la référence de install pour l'ensemble complet des options.

4. Vérifier

Matérialiser n'est que la moitié du travail : verify confirme que les fichiers de configuration attendus de l'environnement ont été écrits et correspondent à ce que déclare le profil :

apothem verify --harness claude-code

claude-code: managed targets verified.

verify se termine avec un code différent de zéro si la configuration manque ou a dérivé, il sert donc aussi de portail dans un script de configuration. Pour un contrôle de santé de toute la machine sur chaque adaptateur enregistré, exécutez :

apothem doctor

doctor signale l'état d'installation de chaque adaptateur et se termine avec un code différent de zéro si un adaptateur enregistré signale qu'il n'est pas installé.

5. Votre première exécution

Ouvrez l'outil que vous venez de configurer — Claude Code, dans cet exemple — et démarrez une session dans n'importe quel projet. Les règles et préférences que vous avez écrites dans le profil à l'Étape 2 font désormais partie du comportement de cet outil. C'est la première exécution fonctionnelle : un profil, façonnant une session réelle.

Quand vous modifiez le profil plus tard, réappliquez-le sans réinstaller :

apothem update --harness claude-code

Étapes suivantes

• Ajouter d'autres environnements — répétez l'Étape 3 par outil.
• Écrire votre première règle — l'unité dont hérite chaque environnement.
• Rédiger un plan — pilotez une mission complète à travers le flux de planification déterministe.
• Référence de la CLI — chaque commande, option et code de sortie.