# @atlashub/smartstack-cli

[![npm version](https://img.shields.io/npm/v/@atlashub/smartstack-cli.svg)](https://www.npmjs.com/package/@atlashub/smartstack-cli)
[![License: Commercial](https://img.shields.io/badge/License-Commercial-blue.svg)](https://atlashub.io/products/smartstack-cli)

**SmartStack** transforms Claude Code into an enterprise-grade development platform. Stop writing boilerplate - start shipping features.

> **SmartStack** is your AI-powered co-pilot for .NET development: automated GitFlow, intelligent migrations, business analysis workflows, and battle-tested methodologies - all integrated directly into Claude Code.

## Why SmartStack?

- **10x Faster Development** - Pre-built workflows eliminate repetitive tasks
- **Enterprise GitFlow** - Full branch management with EF Core migration safety
- **Business Analysis Built-in** - From requirements to implementation handoff
- **Zero Configuration** - Install once, use everywhere

**By [AtlasHub](https://www.atlashub.ch)** | [support@atlashub.ch](mailto:support@atlashub.ch)

---

## Prerequisites

Before installing SmartStack CLI, verify that the following tools are installed:

| Tool | Minimum version | Verification |
|------|----------------|--------------|
| **Node.js** | >= 18.0.0 | `node --version` |
| **npm** | >= 9.0.0 | `npm --version` |
| **Git** | >= 2.0.0 | `git --version` |
| **.NET SDK** | >= 10.0.0 | `dotnet --version` |
| **Claude Code** | latest | `claude --version` |

```powershell
# Verify all prerequisites at once
node --version && npm --version && git --version && dotnet --version && claude --version
```

> **Node.js** : [nodejs.org](https://nodejs.org/) | **.NET SDK** : [dotnet.microsoft.com](https://dotnet.microsoft.com/download) | **Claude Code** : [code.claude.com/docs/en/setup](https://code.claude.com/docs/en/setup)
>
> **Install Claude Code (native - recommended):**
> - **Windows PowerShell**: `irm https://claude.ai/install.ps1 | iex`
> - **Windows (WinGet)**: `winget install Anthropic.ClaudeCode`
> - **WSL (Ubuntu on Windows)**: `curl -fsSL https://claude.ai/install.sh | bash`
> - **macOS / Linux**: `curl -fsSL https://claude.ai/install.sh | bash`

---

## Installation

```powershell
# 1. Install SmartStack CLI
npm install -g @atlashub/smartstack-cli

# 2. Add npm to PATH (permanent)
$npmPath = "$env:APPDATA\npm"
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$npmPath", "User")

# 3. Reload PATH in this session
$env:PATH += ";$npmPath"

# 4. Activate your license (or request a free trial)
smartstack license activate <your-key>
# smartstack license trial

# 5. Deploy skills, agents and hooks
smartstack install
```

> **License required:** every command except `ss license` and `ss doctor` needs an active license. Purchase at [atlashub.io/products/smartstack-cli](https://atlashub.io/products/smartstack-cli).

> **Alias available:** You can use `ss` instead of `smartstack` (e.g., `ss install`).

---

## Documentation

Once installed, open the interactive documentation in your browser:

```powershell
ss docs
```

The documentation covers the full installation checklist, license activation, all CLI commands, Claude Code skills (GitFlow, EF Core, Business Analysis, development pipeline), project creation, troubleshooting, and more.

```powershell
ss docs installation    # Installation guide
ss docs gitflow         # GitFlow workflow
ss docs efcore          # EF Core migrations
ss docs --list          # List all available pages
```

### Command not recognized?

If `ss` or `smartstack` is not recognized after installation:

1. **Close and reopen your terminal** (PowerShell) to reload the PATH
2. If the problem persists, manually add npm to the PATH:
   ```powershell
   $npmPath = "$env:APPDATA\npm"
   [Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$npmPath", "User")
   $env:PATH += ";$npmPath"
   ```
3. Verify that the package is installed:
   ```powershell
   npm list -g @atlashub/smartstack-cli
   ```

---

**[AtlasHub](https://www.atlashub.ch)** | [support@atlashub.ch](mailto:support@atlashub.ch) | Commercial license