1 <!-- LOGO -->
2 <h1>
3 <p align="center">
4 <img src="https://avatars.githubusercontent.com/u/89791739?s=200&v=4" alt="smbCloud Logo" width="128">
5 <br>smbCloud CLI
6 </h1>
7 <p align="center">
8 Deploy with smbCloud from your terminal.
9 <br />
10 <br />
11 <a href="https://smbcloud.xyz/">Website</a>
12 ·
13 <a href="https://smbcloud.xyz/posts">Documentation</a>
14 ·
15 <a href="https://github.com/smbcloudXYZ/smbcloud-cli/releases">Releases</a>
16 ·
17 <a href="https://github.com/smbcloudXYZ/smbcloud-cli/issues">Issues</a>
18 </p>
19 <p align="center">
20 <a href="https://www.npmjs.com/package/@smbcloud/cli"><img alt="npm" src="https://img.shields.io/npm/v/@smbcloud/cli"></a>
21 <a href="https://www.nuget.org/packages/SmbCloud.Cli"><img alt="NuGet" src="https://img.shields.io/nuget/v/SmbCloud.Cli"></a>
22 <a href="https://pypi.org/project/smbcloud-cli/"><img alt="PyPI" src="https://img.shields.io/pypi/v/smbcloud-cli"></a>
23 <a href="https://github.com/smbcloudXYZ/smbcloud-cli/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/smbcloudXYZ/smbcloud-cli"></a>
24 </p>
25 </p>
26
27 ## About
28
29 **`smb`** is the command-line interface for [smbCloud](https://smbcloud.xyz/).
30
31 Install it with npm, then run the native `smb` binary for your platform.
32
33 ## Install
34
35 ```sh
36 npm install -g @smbcloud/cli
37 ```
38
39 This package downloads the right pre-built native binary for your platform.
40
41 ## Quick Start
42
43 ```sh
44 smb login
45 smb init
46 smb deploy
47 ```
48
49 That gets you from login to first deploy.
50
51 ## Other Installation Methods
52
53 ### Homebrew (macOS & Linux)
54
55 ```sh
56 brew tap smbcloudXYZ/tap
57 brew install cli
58 ```
59
60 ### .NET tool
61
62 ```sh
63 dotnet tool install --global SmbCloud.Cli
64 ```
65
66 ### pip
67
68 ```sh
69 pip install smbcloud-cli
70 ```
71
72 ### Shell (macOS / Linux)
73
74 ```sh
75 curl -fsSL https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-unix.sh | sh
76 ```
77
78 ### PowerShell (Windows)
79
80 ```powershell
81 irm https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-windows.sh | iex
82 ```
83
84 ## Documentation
85
86 Full documentation is available at [smbcloud.xyz/posts](https://smbcloud.xyz/posts).
87
88 ## Platform Support
89
90 This package ships pre-built native binaries for:
91
92 | Platform | Architecture |
93 | ------------- | ------------ |
94 | macOS | arm64, x64 |
95 | Linux (glibc) | arm64, x64 |
96 | Windows | arm64, x64 |
97
98 ## Source & Issues
99
100 This package ships the native `smb` binary through npm.
101 Source code and issue tracker:
102 [github.com/smbcloudXYZ/smbcloud-cli](https://github.com/smbcloudXYZ/smbcloud-cli).
103
104 You can find the main install and deploy guides in the [smbCloud CLI docs](https://smbcloud.xyz/posts).
105
106 ## License
107
108 [Apache-2.0](https://github.com/smbcloudXYZ/smbcloud-cli/blob/main/LICENSE)
109
110 ## Copyright
111
112 © 2026 [Splitfire AB](https://5mb.app) ([smbCloud](https://smbcloud.xyz)).