## Commandes CLI SmartStack SmartStack CLI Commands

SmartStack CLI fournit des commandes en ligne de commande pour gerer l'installation, la configuration et le diagnostic de votre environnement de developpement.

SmartStack CLI provides command-line tools to manage installation, configuration and diagnostics of your development environment.

💡

##### Alias

Toutes les commandes supportent l'alias court `ss`. Exemple: `ss doctor` au lieu de `smartstack doctor`

All commands support the short alias `ss`. Example: `ss doctor` instead of `smartstack doctor`

#### Vue d'ensemble des commandes

#### Commands Overview

Commande | Command | Description | Description
--- | --- | --- | ---
`smartstack install` | Installe les templates SmartStack | Install SmartStack templates
`smartstack uninstall` | Supprime les templates SmartStack | Remove SmartStack templates
`smartstack status` | Affiche le statut d'installation | Show installation status
`smartstack update` | Met a jour les templates | Update templates
`smartstack init` | Cree un nouveau projet SmartStack | Create a new SmartStack project
`smartstack doctor` | Diagnostic complet du systeme | Full system diagnostics
`smartstack check-mcp` | Verifie les serveurs MCP | Check MCP servers
`smartstack ralph` | Gestion de Ralph Weegund | Ralph Weegund management
`smartstack license` | Gestion de la licence | License management
`smartstack docs` | Ouvre la documentation | Open documentation

## smartstack install

Installe les commandes, agents, hooks et skills SmartStack dans Claude Code.

Install SmartStack commands, agents, hooks and skills into Claude Code.

    smartstack install [options]

    # Exemples
    smartstack install              # Installation globale
    smartstack install --local      # Installation projet
    smartstack install --force      # Ecrase les fichiers existants

#### Options

Option | Alias | Description | Description
--- | --- | --- | ---
`--global` | `-g` | Installe dans ~/.claude (defaut) | Install to ~/.claude (default)
`--local` | `-l` | Installe dans ./.claude (projet) | Install to ./.claude (project)
`--force` | `-f` | Ecrase les fichiers existants | Overwrite existing files
`--commands-only` |  | Installe uniquement les commandes | Install commands only
`--agents-only` |  | Installe uniquement les agents | Install agents only

## smartstack status

Affiche le statut de l'installation SmartStack et les informations du projet courant.

Display SmartStack installation status and current project information.

    smartstack status [options]

    # Exemples
    smartstack status              # Statut global
    smartstack status --local      # Statut projet
    smartstack status --verbose    # Details complets

#### Options

Option | Alias | Description | Description
--- | --- | --- | ---
`--global` | `-g` | Verifie ~/.claude (defaut) | Check ~/.claude (default)
`--local` | `-l` | Verifie ./.claude | Check ./.claude
`--verbose` | `-v` | Affiche la liste des commandes | Show command list

## smartstack init

Cree un nouveau projet SmartStack complet avec backend .NET et frontend React.

Create a complete new SmartStack project with .NET backend and React frontend.

    smartstack init <name> [options]

    # Exemples
    smartstack init MyProject              # Interactif
    smartstack init MyProject -y           # Valeurs par defaut
    smartstack init MyProject --db postgresql   # Avec PostgreSQL
    smartstack init MyProject --dry-run    # Simulation

#### Options

Option | Description | Description
--- | --- | ---
`--db <type>` | Base de donnees: sqlserver, postgresql, sqlite | Database: sqlserver, postgresql, sqlite
`--dry-run` | Simulation sans creation de fichiers | Simulate without creating files
`-y, --yes` | Utilise les valeurs par defaut | Use default values
`--skip-mcp-check` | Ignore la verification des MCP | Skip MCP servers check

💡

##### Inclut Ralph

##### Includes Ralph

`smartstack init` configure automatiquement Ralph Weegund dans le projet avec le dossier `.ralph/` et sa configuration.

`smartstack init` automatically configures Ralph Weegund in the project with the `.ralph/` folder and configuration.

## smartstack doctor

Execute un diagnostic complet du systeme SmartStack: licence, environnement, MCP servers, installation, et configuration Ralph.

Run a complete SmartStack system diagnostic: license, environment, MCP servers, installation, and Ralph configuration.

    smartstack doctor [options]

    # Exemples
    smartstack doctor              # Diagnostic complet
    smartstack doctor --verbose    # Avec details
    smartstack doctor --json       # Output JSON (CI/CD)

#### Options

Option | Description | Description
--- | --- | ---
`--json` | Output en JSON (pour CI/CD) | JSON output (for CI/CD)
`-v, --verbose` | Affiche les details etendus | Show extended details

#### Verifications effectuees

#### Checks performed

🔑 Licence valide Valid license
📗 Node.js >= 18
🛠 .NET SDK
🔌 Git
🤖 Claude Code CLI
🔌 MCP: context7
🔌 MCP: smartstack
📦 Templates installes Templates installed
🔄 Config Ralph Ralph config

#### Exemple de sortie

#### Example output

    ╔══════════════════════════════════════════════════════════╗
    ║   SmartStack Doctor - System Diagnostics                 ║
    ║   Version 1.11.0                                         ║
    ╚══════════════════════════════════════════════════════════╝

    Component              Status          Details
    ─────────────────────────────────────────────────────────────
    License                ✓ OK            Valid (professional)
    Node.js                ✓ OK            v20.10.0
    npm                    ✓ OK            10.2.0
    Git                    ✓ OK            2.43.0
    .NET SDK               ✓ OK            10.0.100
    Claude Code            ✓ OK            1.0.0
    MCP: context7          ✓ OK            Available
    MCP: smartstack        ✓ OK            Available
    SmartStack Commands    ✓ OK            42 commands
    SmartStack Agents      ✓ OK            12 agents
    Ralph Config           ✓ OK            Configured

    Summary:
      ✓ 11 OK

    SmartStack is healthy!

## smartstack check-mcp

Verifie la disponibilite des serveurs MCP requis pour SmartStack et Ralph. Peut installer automatiquement les serveurs manquants.

Check availability of MCP servers required for SmartStack and Ralph. Can automatically install missing servers.

    smartstack check-mcp [options]

    # Exemples
    smartstack check-mcp              # Verification
    smartstack check-mcp --install    # Auto-installation
    smartstack check-mcp --json       # Output JSON

#### Options

Option | Description | Description
--- | --- | ---
`--install` | Installe automatiquement les MCP manquants | Automatically install missing MCPs
`--json` | Output en JSON | JSON output

#### Serveurs MCP requis

#### Required MCP servers

Server | Description | Description | Installation | Installation
--- | --- | --- | --- | ---
context7 | Documentation et exemples de code des librairies | Library documentation and code examples | `claude mcp add context7 -- npx @upstash/context7-mcp`
smartstack | Validation conventions, scaffolding, API docs | Convention validation, scaffolding, API docs | `claude mcp add smartstack -- npx --package @atlashub/smartstack-cli smartstack-mcp` (auto via install)(auto via install)

⚠

##### Important pour Ralph

##### Important for Ralph

Ralph Weegund refuse de demarrer si les serveurs MCP ne sont pas disponibles. Utilisez cette commande pour verifier avant de lancer Ralph.

Ralph Weegund refuses to start if MCP servers are not available. Use this command to verify before starting Ralph.

## smartstack ralph

Gestion de Ralph Weegund - le systeme d'automatisation iteratif avec validation MCP obligatoire, logging et rapports.

Ralph Weegund management - the iterative automation system with mandatory MCP validation, logging and reports.

    smartstack ralph <command> [options]

    # Sous-commandes disponibles
    smartstack ralph start     # Verification pre-vol et preparation
    smartstack ralph status    # Affiche le statut de Ralph
    smartstack ralph logs      # Affiche les logs recents
    smartstack ralph report    # Liste ou affiche les rapports
    smartstack ralph init      # Initialise Ralph dans le projet

#### Sous-commandes

#### Subcommands

`ralph start` Principal Main

Execute la verification pre-vol de Ralph: Claude Code, serveurs MCP, configuration, repertoires.

Run Ralph pre-flight check: Claude Code, MCP servers, configuration, directories.

    smartstack ralph start [options]

    Options:
      --skip-mcp    Ignore la verification MCP (non recommande)

`ralph status` Info

Affiche le statut actuel de Ralph: configuration, MCP, logs, rapports recents.

Display current Ralph status: configuration, MCP, logs, recent reports.

    smartstack ralph status

`ralph logs` Info

Affiche les logs recents de Ralph (appels MCP, iterations, erreurs).

Display recent Ralph logs (MCP calls, iterations, errors).

    smartstack ralph logs [options]

    Options:
      -n, --lines <n>    Nombre de lignes (defaut: 50)

`ralph report` Info

Liste ou affiche les rapports de features generes par Ralph.

List or display feature reports generated by Ralph.

    smartstack ralph report [options] [name]

    Options:
      --list    Liste tous les rapports
      --last    Affiche le dernier rapport

    Exemples:
      smartstack ralph report --list        # Liste tous
      smartstack ralph report --last        # Dernier rapport
      smartstack ralph report feature-xyz   # Rapport specifique

`ralph init` Setup

Initialise Ralph dans le projet courant: cree le dossier `.ralph/` avec la configuration.

Initialize Ralph in the current project: creates the `.ralph/` folder with configuration.

    smartstack ralph init [options]

    Options:
      -f, --force    Ecrase la configuration existante

#### Structure .ralph/

#### .ralph/ Structure

    .ralph/
    ├── ralph.config.yaml    # Configuration Ralph
    ├── logs/                # Logs des sessions
    │   └── ralph-YYYY-MM-DD.log
    ├── reports/             # Rapports de features
    │   └── feature-xxx-timestamp.md
    └── README.md            # Documentation

🔄

##### Utilisation dans Claude Code

##### Usage in Claude Code

Apres `smartstack ralph start`, utilisez `/ralph-loop "Votre tache"` dans Claude Code pour demarrer l'automatisation.

After `smartstack ralph start`, use `/ralph-loop "Your task"` in Claude Code to start automation.

## smartstack license

Gestion de la licence SmartStack CLI.

SmartStack CLI license management.

    smartstack license <command> [options]

    # Commandes
    smartstack license activate <key>    # Active une licence
    smartstack license status             # Affiche le statut
    smartstack license deactivate         # Supprime la licence
    smartstack license verify <key>      # Verifie sans activer

#### Commandes

#### Commands

Commande | Command | Description | Description
--- | --- | --- | ---
`activate <key>` | Active une cle de licence | Activate a license key
`status` | Affiche le statut de la licence | Show license status
`deactivate` | Supprime la licence actuelle | Remove current license
`verify <key>` | Verifie une cle sans l'activer | Verify a key without activating