quickstart

Première exécution guidée : s'assure qu'un profil existe, prévisualise les écritures, puis installe.

Synopsis

apothem quickstart [--harness NAME|all] [--project PATH] [--profile PATH]
                   [--yes] [--quiet|-q] [--verbose|-v]
                   [--format plain|json] [--json] [--no-color]

quickstart est l'unique point d'entrée guidé pour un nouvel opérateur. Dans un flux linéaire, il : (1) s'assure qu'un profil partagé existe — en créant un profil de départ avec une invitation à le personnaliser si aucun n'est trouvé ; (2) prévisualise les fichiers concrets que les harness sélectionnés écriront, regroupés par racine du projet par rapport à votre répertoire personnel ; (3) demande confirmation ; (4) installe avec la sortie des notes de capacités regroupée et débarrassée du bruit ; et (5) imprime les commandes suivantes recommandées.

Il compose les mêmes briques que celles qu'utilise la commande install — il ne les réimplémente pas. --harness vaut all par défaut et --project le répertoire courant.

Comportement

• Profil — si le chemin de profil résolu ne comporte pas de fichier, quickstart propose de créer un profil de départ (le crée automatiquement avec --yes, dans un shell non interactif ou avec --format json) et nomme les champs d'identité d'espace réservé à personnaliser.
• Prévisualiser + confirmer — avant toute écriture, les cibles sont listées sous deux en-têtes (racine du projet par rapport à votre répertoire personnel) ; une exécution interactive confirme avant d'écrire en dehors du projet. --yes, un shell non interactif et --format json poursuivent sans demander. Refuser interrompt avant toute écriture.
• Installer — les capacités qu'un harness ne prend pas en charge nativement sont résumées en une note regroupée par harness (passez --verbose pour le détail par capacité) ; l'ensemble complet figure toujours dans le tableau warnings de --format json.
• Étape suivante — la sortie du terminal nomme les commandes ultérieures (apothem verify …, apothem doctor).

Options

Sortie JSON

--format json émet un document unique qui résume chaque étape guidée :

{
  "status": "success",
  "command": "quickstart",
  "profile_path": "C:\\Users\\Example\\.config\\apothem\\profile.yaml",
  "steps": [
    {"step": "profile", "outcome": "created", "path": "…", "placeholder_identity": ["name", "email", "github"]},
    {"step": "install", "status": "success", "harness": "all", "files_written": ["…"], "warnings": [], "results": []},
    {"step": "recommend", "next": ["apothem verify --harness all --project .", "apothem doctor"]}
  ],
  "recommended_next": ["apothem verify --harness all --project .", "apothem doctor"]
}

Exemples

apothem quickstart
apothem quickstart --harness all --project . --yes
apothem quickstart --harness claude-code
apothem quickstart --json

Codes de sortie

Voir aussi

• apothem install — matérialise un harness à partir du profil partagé
• apothem verify — confirme qu'une installation est active
• apothem doctor — santé de l'environnement et de l'installation
• Premiers pas — guide d'installation complet