## Prerequis Prerequisites

📗 Node.js >= 18.0.0
📦 npm >= 8.0.0
🤖 Claude Code (CLI d'Anthropic)

    # Verifier les versions
    node --version  # v18.x.x ou superieur
    npm --version   # v8.x.x ou superieur

## Installation rapide Quick Install

    # Installer le package
    npm install -g @atlashub/smartstack-cli

    # Installer les commandes
    smartstack-cli install

## Installation globale (recommandee) Global Installation (recommended)

L'installation globale installe les commandes dans `~/.claude`, les rendant disponibles dans tous vos projets.

Global installation installs commands to `~/.claude`, making them available in all your projects.

1. ##### Installer le package npm

   ##### Install npm package

       npm install -g @atlashub/smartstack-cli

2. ##### Activer votre licence

   ##### Activate your license

       smartstack-cli activate YOUR-LICENSE-KEY

3. ##### Installer les commandes

   ##### Install commands

       smartstack-cli install

4. ##### Verifier l'installation

   ##### Verify installation

       smartstack-cli status

## Installation locale (projet) Local Installation (project)

L'installation locale installe les commandes dans `./.claude` du projet courant. Utile pour personnaliser les commandes par projet.

Local installation installs commands to `./.claude` in the current project. Useful for customizing commands per project.

    # Dans votre projet
    npm install -D @atlashub/smartstack-cli

    # Installer localement
    npx smartstack-cli install --local

⚠

##### Ajoutez .claude au .gitignore

##### Add .claude to .gitignore

Si vous installez localement, pensez a ajouter `.claude/` a votre `.gitignore` pour eviter de commiter les fichiers de configuration.

If you install locally, consider adding `.claude/` to your `.gitignore` to avoid committing configuration files.

## Serveurs MCP (recommande) MCP Servers (recommended)

Les serveurs MCP (Model Context Protocol) enrichissent SmartStack avec des fonctionnalites avancees : validation de conventions, scaffolding, documentation en temps reel.

MCP servers (Model Context Protocol) enhance SmartStack with advanced features: conventions validation, scaffolding, real-time documentation.

Serveur | Fonction Function
--- | ---
SmartStack MCP | Validation conventions, scaffolding, API docs Conventions validation, scaffolding, API docs
Context7 MCP | Documentation libraries, exemples de code Library documentation, code examples

### Installation

    # SmartStack MCP
    claude mcp add smartstack

    # Context7 MCP (remplacez YOUR_API_KEY par votre cle)
    claude mcp add context7 -- npx @upstash/context7-mcp -- --api-key YOUR_API_KEY

⚠

##### Cle API Context7

##### Context7 API Key

Obtenez votre cle API gratuite sur context7.io

Get your free API key at context7.io

💡

##### Verifier l'installation

##### Verify installation

`claude mcp list`

## Options d'installation Installation Options

Option | Description Description
--- | ---
`--local` | Installer dans le projet courant (./.claude) Install in current project (./.claude)
`--commands-only` | Installer uniquement les commandes Install commands only
`--agents-only` | Installer uniquement les agents Install agents only
`--hooks-only` | Installer uniquement les hooks Install hooks only
`--force` | Forcer la reecriture des fichiers existants Force overwrite existing files
`--no-config` | Ne pas creer le fichier de configuration Skip config file creation

## Structure des fichiers File Structure

Apres installation, la structure suivante est creee :

After installation, the following structure is created:

    ~/.claude/                    # Installation globale
    ├── commands/                 # Commandes slash
    │   ├── gitflow.md           # Orchestrateur GitFlow
    │   ├── gitflow/             # Phases GitFlow
    │   │   ├── 1-init.md
    │   │   ├── 2-status.md
    │   │   ├── 3-commit.md
    │   │   ├── 4-plan.md
    │   │   ├── 5-exec.md
    │   │   ├── 6-abort.md
    │   │   ├── 10-start.md
    │   │   └── 11-finish.md
    │   ├── apex.md              # Orchestrateur APEX
    │   ├── apex/                # Phases APEX
    │   ├── git/                 # Commandes Git
    │   └── prompts/             # Generateurs de prompts
    ├── agents/                   # Agents specialises
    │   ├── explore-codebase.md
    │   ├── explore-docs.md
    │   ├── websearch.md
    │   ├── snipper.md
    │   ├── fix-grammar.md
    │   └── action.md
    ├── hooks/                    # Hooks Claude Code
    │   └── hooks.json
    └── gitflow/                  # Donnees GitFlow
        ├── config.json          # Configuration
        ├── plans/               # Plans d'integration
        ├── logs/                # Logs d'operations
        └── migrations/          # Suivi des migrations
            └── history.json

## Desinstallation Uninstallation

    # Desinstaller tous les composants
    smartstack-cli uninstall

    # Desinstaller des composants specifiques
    smartstack-cli uninstall --commands-only
    smartstack-cli uninstall --agents-only
    smartstack-cli uninstall --hooks-only

    # Garder le fichier de configuration
    smartstack-cli uninstall --keep-config

    # Sans confirmation
    smartstack-cli uninstall --yes

## Mise a jour Update

    # Mettre a jour le package npm
    npm update -g @atlashub/smartstack-cli

    # Mettre a jour les commandes installees
    smartstack-cli update

## Resolution de problemes Troubleshooting

⚠

##### Erreur de permission

##### Permission error

Si vous obtenez une erreur de permission lors de l'installation globale, utilisez `sudo` ou configurez npm pour utiliser un repertoire utilisateur.

If you get a permission error during global installation, use `sudo` or configure npm to use a user directory.

💡

##### Commandes non reconnues

##### Commands not recognized

Assurez-vous que le repertoire npm global est dans votre PATH. Verifiez avec `npm bin -g`.

Make sure the npm global directory is in your PATH. Check with `npm bin -g`.