Guide des commandes

Chaque commande SMART, expliquée.

Utilisez cette référence pour comprendre l’effet d’une commande, puis copiez la forme exacte dont vous avez besoin.

Référence des commandes

Les exemples de génération utilisent --dry-run pour produire un plan vérifiable sans écrire. Remplacez-le par --yes uniquement après avoir examiné les fichiers prévus.

Vérification de l’environnement

Valide le catalogue de génération intégré et chaque modèle enregistré avant de générer un projet.

smart doctor
Catalogue de génération

Répertorie les recettes de génération pilotées par les données et leurs identifiants.

smart catalog list

Affiche l’objectif, les rôles requis, les paramètres et la version d’une recette.

smart catalog describe service/edocument
Projets

Prépare le plan d’un nouveau projet SOKit rc8 avec une identité, un package et une topologie de dépôt explicites.

smart project init ./platform --id platform --name Platform --group com.example --base-package com.example.platform --topology monorepo --dry-run

Inspecte un dépôt existant et prépare les paramètres SMART sans remplacer ses fichiers applicatifs.

smart project adopt . --dry-run

Lit la topologie, les paramètres, les composants et les indices détectés sans modifier le projet.

smart project inspect .

Vérifie les paramètres et fichiers détectés, puis signale des diagnostics de validation exploitables.

smart project validate .
Applications UI

Prépare une application SOKit UI 1.1.4 dans le projet et l’emplacement sélectionnés.

smart app add ui portal --project . --dry-run
Services

Prépare un service de documents électroniques rc8 avec ses modules de données et de documents.

smart service add edocument documents --project . --dry-run

Prépare le service de référence rc8 unique du projet et ses modules de persistance.

smart service add reference references --project . --dry-run

Prépare le service de stockage rc8 unique du projet avec le pilote sélectionné.

smart service add bucket files --project . --dry-run

Prépare le service de notification rc8 unique du projet et ses pilotes de livraison facultatifs.

smart service add notifier notifications --project . --dry-run
Périmètres de stockage

Prépare un périmètre validé pour un service de stockage existant, avec stockage, limites, types de média et rôles.

smart bucket scope add attachments --storage primary --project . --dry-run
Authentification

Ouvre la connexion sécurisée dans le navigateur et enregistre les identifiants SMART obtenus pour ce profil.

smart auth login

Affiche un QR local, une URL de vérification et un code court, puis attend la connexion depuis n’importe quel navigateur.

smart auth login --device

Actualise la session SMART actuelle et charge immédiatement ses rôles effectifs.

smart auth refresh

Indique si le profil actuel est connecté et quelle identité il utilise.

smart auth status

Déconnecte SMART et supprime les identifiants enregistrés localement pour le profil actuel.

smart auth logout

Connexion par appareil, du terminal à SMART

Une séquence locale authentique d’un flux d’autorisation d’appareil complet avec le CLI SMART natif compilé. Les formulaires du code et des identifiants sont présentés séparément, mais leur saisie est omise ; aucun mot de passe, jeton ou identifiant réutilisable n’apparaît.

Lire la transcription
  1. Exécutez smart auth login --device ; SMART affiche dans le terminal un QR code local, une URL de vérification et un code court à usage unique.
  2. Le véritable formulaire Device Login de Keycloak montre où saisir le code à usage unique ; le champ reste vide dans l’enregistrement.
  3. Après l’envoi du code, Keycloak demande un nom d’utilisateur et un mot de passe ; la saisie des identifiants est volontairement omise.
  4. Keycloak confirme Device Login Successful dans cette même session menée à terme.
  5. La même session du CLI SMART natif affiche Signed in to SMART et confirme les rôles skills:sokit et tools:sokit.
Service SMART local

Démarre le service MCP SMART local pour le profil actuellement connecté.

smart mcp start

Indique si le service MCP SMART local fonctionne et comment les clients peuvent le joindre.

smart mcp status

Arrête le service MCP SMART local sans supprimer les intégrations des agents.

smart mcp stop
Intégrations des agents

Connecte Codex au service MCP SMART local tout en préservant la configuration sans rapport.

smart mcp integrate codex on

Supprime uniquement les entrées gérées par SMART de l’intégration Codex.

smart mcp integrate codex off

Connecte Claude Code au service MCP SMART local tout en préservant la configuration sans rapport.

smart mcp integrate claude on

Supprime uniquement les entrées gérées par SMART de l’intégration Claude Code.

smart mcp integrate claude off

Connecte Cursor au service MCP SMART local tout en préservant la configuration sans rapport.

smart mcp integrate cursor on

Supprime uniquement les entrées gérées par SMART de l’intégration Cursor.

smart mcp integrate cursor off

Connecte Cline au service MCP SMART local tout en préservant la configuration sans rapport.

smart mcp integrate cline on

Supprime uniquement les entrées gérées par SMART de l’intégration Cline.

smart mcp integrate cline off

Connecte Gemini CLI au service MCP SMART local tout en préservant la configuration sans rapport.

smart mcp integrate gemini-cli on

Supprime uniquement les entrées gérées par SMART de l’intégration Gemini CLI.

smart mcp integrate gemini-cli off

Connecte GitHub Copilot CLI au service MCP SMART local tout en préservant la configuration sans rapport.

smart mcp integrate github-copilot-cli on

Supprime uniquement les entrées gérées par SMART de l’intégration GitHub Copilot CLI.

smart mcp integrate github-copilot-cli off

Connecte Windsurf au service MCP SMART local tout en préservant la configuration sans rapport.

smart mcp integrate windsurf on

Supprime uniquement les entrées gérées par SMART de l’intégration Windsurf.

smart mcp integrate windsurf off

Connecte Zed au service MCP SMART local tout en préservant la configuration sans rapport.

smart mcp integrate zed on

Supprime uniquement les entrées gérées par SMART de l’intégration Zed.

smart mcp integrate zed off

Connecte VS Code au service MCP SMART local tout en préservant la configuration sans rapport.

smart mcp integrate vscode on

Supprime uniquement les entrées gérées par SMART de l’intégration VS Code.

smart mcp integrate vscode off

Connecte JetBrains au service MCP SMART local tout en préservant la configuration sans rapport.

smart mcp integrate jetbrains on

Supprime uniquement les entrées gérées par SMART de l’intégration JetBrains.

smart mcp integrate jetbrains off
Complétion du shell

Génère les définitions de complétion des commandes pour le shell bash.

smart completion bash

Génère les définitions de complétion des commandes pour le shell zsh.

smart completion zsh

Génère les définitions de complétion des commandes pour le shell fish.

smart completion fish

Génère les définitions de complétion des commandes pour le shell pwsh.

smart completion pwsh

Génère les définitions de complétion des commandes pour le shell nu.

smart completion nu
Désinstallation

Arrête SMART et supprime ses intégrations d’agents et fichiers de service gérés.

smart mcp uninstall
Sortie lisible par machine

Renvoie l’état d’authentification en JSON pour les scripts et outils de développement.

smart auth status --json

Renvoie l’état du service MCP SMART local en JSON pour les scripts et contrôles d’intégrité.

smart mcp status --json
Aide et version

Répertorie les groupes de commandes SMART et les options disponibles pour chacun.

smart help

Affiche la même aide générale avec la forme standard de l’option.

smart --help

Affiche la version installée de l’outil SMART.

smart version

Affiche la version installée de l’outil SMART avec la forme standard de l’option.

smart --version