@smbcloud / cli
Code Commits Issues Pulls Cloud Agent CI/CD
main
claude/smbcloud-github-app-k9641p development feature/apps feature/build-release feature/ci-docs feature/ci-ruby-gems feature/cicd feature/completion feature/dist-nuget feature/fix-ci-sdk-pypi-rubygem feature/fix-clippy-on-stable-channel feature/fix-deployment-script feature/github-email feature/gresiq-v1 feature/project-new-structure feature/rsync-deploy feature/ruby-runner feature/sdk-npm feature/sdk-workflows feature/smbcloud-cli-release-npm feature/smbcloud-deploy feature/wasm main release/v0.7.4
md 93 lines 2.89 KB
Rendered Raw
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>xcrs
6 </h1>
7 <p align="center">
8 Cross-platform mobile and TV app automation over MCP.
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://pypi.org/project/xcrs/"><img alt="PyPI" src="https://img.shields.io/pypi/v/xcrs"></a>
21 <a href="https://www.npmjs.com/package/@smbcloud/xcrs"><img alt="npm" src="https://img.shields.io/npm/v/@smbcloud/xcrs"></a>
22 <a href="https://www.nuget.org/packages/SmbCloud.Xcrs"><img alt="NuGet" src="https://img.shields.io/nuget/v/SmbCloud.Xcrs"></a>
23 <a href="https://crates.io/crates/xcrs"><img alt="Crates.io" src="https://img.shields.io/crates/v/xcrs"></a>
24 <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>
25 </p>
26 </p>
27
28 ## About
29
30 **`xcrs`** drives mobile and TV apps — on iOS simulators, physical Apple
31 devices, and adb-connected Android phones, tablets, emulators, and TVs — through
32 the [Model Context Protocol](https://modelcontextprotocol.io/). It is the
33 standalone automation profile of the [smbCloud CLI](https://smbcloud.xyz/); the
34 same tools are also available via `smb --mcp --scope automation`.
35
36 This package installs the native `xcrs` executable for your platform directly —
37 no Node.js, no Docker, no runtime dependencies.
38
39 ## Install
40
41 ```sh
42 pip install xcrs
43 ```
44
45 Or run it without installing:
46
47 ```sh
48 uvx xcrs --mcp
49 ```
50
51 ## Quick start
52
53 Run it as an MCP server over stdio and point your MCP client at it:
54
55 ```sh
56 xcrs --mcp
57 ```
58
59 **Recommended flow:** `device_list` → `device_select` → `device_capabilities`,
60 then inspect with `screen_capture` / `ui_describe` and drive with the `input_*`
61 tools.
62
63 ## Other installation methods
64
65 - Cargo: `cargo install xcrs`
66 - npm: `npm install -g @smbcloud/xcrs`
67 - NuGet: `dotnet tool install --global SmbCloud.Xcrs`
68
69 ## Platform support
70
71 | Platform | Architecture |
72 | ------------- | ------------ |
73 | macOS | arm64, x64 |
74 | Linux (glibc) | arm64, x64 |
75 | Windows | x64 |
76
77 The full Apple automation surface (`ui_describe`, `ui_element_list`, simulator
78 control) requires macOS with Xcode command-line tools. Android automation over
79 `adb` works from any platform.
80
81 ## Source
82
83 - Repository: <https://github.com/smbcloudXYZ/smbcloud-cli>
84 - Documentation: <https://smbcloud.xyz/posts>
85 - Issues: <https://github.com/smbcloudXYZ/smbcloud-cli/issues>
86
87 ## License
88
89 Apache-2.0
90
91 ## Copyright
92
93 © 2026 [Splitfire AB](https://5mb.app) ([smbCloud](https://smbcloud.xyz)).