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