smbCloud Mail & Auth

smbCloud CLI

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

Website · Documentation · Contributing · Releases

About

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.

Send transactional email and set up 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.

Install

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

Homebrew (macOS & Linux)

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

npm

npm install -g @smbcloud/cli

.NET tool

dotnet tool install --global SmbCloud.Cli

pip

pip install smbcloud-cli

Shell (macOS / Linux)

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

PowerShell (Windows)

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

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

Quick Start

smb login
smb init
smb deploy

That gets you from login to first deploy.

MCP server

smb --mcp speaks the Model Context Protocol over stdio, exposing 31 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.

For mobile and TV app testing, run the focused XCRS Mobile & TV Automation profile:

claude mcp add xcrs -- smb --mcp --scope automation

It exposes target-aware Xcode, ControlKit, CoreDevice, and adb tools without mixing them into the cloud tool set. The same profile is also available from the standalone xcrs --mcp crate.

CI / non-interactive mode

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.

Documentation

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

Contributing

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

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

License

Apache-2.0

Copyright

© 2026 Splitfire AB (smbCloud).