smbCloud Mail, Auth, Deploy, and GresIQ from your terminal or your AI agent.

Website · Documentation · Contributing · Releases

smb is the command-line interface for smbCloud. It is also an MCP server, so Claude, Cursor, and other AI agents can run the same operations you do.

Set up email domains and inbox routing on smbCloud Mail, manage authentication apps on smbCloud Auth, and deploy Rust, Node.js, Ruby, or Swift apps. One binary, no runtime to install.

If you want the quickest setup, use a pre-built native binary.

brew tap smbcloudXYZ/tap && brew trust --tap smbcloudXYZ/tap
brew install cli

npm install -g @smbcloud/cli

dotnet tool install --global SmbCloud.Cli

pip install smbcloud-cli

curl -fsSL https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-unix.sh | sh

irm https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-windows.sh | iex

Or grab a pre-built binary from the Releases page.

smb login
smb init
smb deploy

That gets you from login to first deploy.

smb --mcp speaks the Model Context Protocol over stdio, exposing 30 tools across smbCloud Mail, Auth, projects, and deployments. It is listed in the official MCP Registry as io.github.smbcloudXYZ/smbcloud-cli.

Claude Code:

claude mcp add smbcloud -- smb --mcp

Claude Desktop, Cursor, and anything else that takes a JSON config:

{
  "mcpServers": {
    "smbcloud": {
      "command": "npx",
      "args": ["@smbcloud/cli", "--mcp"]
    }
  }
}

Auth comes from smb login, so a terminal session and an agent session share the same token and the same selected project. See docs/mcp.md for the full tool reference.

Pass --ci (or set SMB_CI=1, or run under any provider that sets CI) to disable interactive prompts. Confirmations take their default; anything that truly needs input fails fast with a clear message instead of hanging on a missing TTY.

smb --ci deploy

For example, the AircraftsHub monorepo deploys its Next.js web app with a single non-interactive command — its .smb/config.toml pins the project, source, and runtime, so smb --ci deploy needs no prompts. See docs/ci.md for token setup and the full behavior reference.

See the docs/ directory for guides on authentication, project configuration, and deployment workflows.

Read CONTRIBUTING.md to get started. Contributions are welcome.

For the broader product, see smbCloud and the deployment docs.

Apache-2.0

© 2026 Splitfire AB (smbCloud).