@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 87 lines 2.81 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://www.npmjs.com/package/@smbcloud/xcrs"><img alt="npm" src="https://img.shields.io/npm/v/@smbcloud/xcrs"></a>
21 <a href="https://www.nuget.org/packages/SmbCloud.Xcrs"><img alt="NuGet" src="https://img.shields.io/nuget/v/SmbCloud.Xcrs"></a>
22 <a href="https://pypi.org/project/xcrs/"><img alt="PyPI" src="https://img.shields.io/pypi/v/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 runtime dependencies.
38
39 ## Install
40
41 ```sh
42 npm install -g @smbcloud/xcrs
43 ```
44
45 ## Quick start
46
47 Run it as an MCP server over stdio and point your MCP client at it:
48
49 ```sh
50 xcrs --mcp
51 ```
52
53 **Recommended flow:** `device_list` → `device_select` → `device_capabilities`,
54 then inspect with `screen_capture` / `ui_describe` and drive with the `input_*`
55 tools.
56
57 ## Other installation methods
58
59 - Cargo: `cargo install xcrs`
60 - pip: `pip install xcrs`
61 - NuGet: `dotnet tool install --global SmbCloud.Xcrs`
62
63 ## Platform support
64
65 | Platform | Architecture |
66 | ------------- | ------------ |
67 | macOS | arm64, x64 |
68 | Linux (glibc) | arm64, x64 |
69 | Windows | arm64, x64 |
70
71 The full Apple automation surface (`ui_describe`, `ui_element_list`, simulator
72 control) requires macOS with Xcode command-line tools. Android automation over
73 `adb` works from any platform.
74
75 ## Source
76
77 - Repository: <https://github.com/smbcloudXYZ/smbcloud-cli>
78 - Documentation: <https://smbcloud.xyz/posts>
79 - Issues: <https://github.com/smbcloudXYZ/smbcloud-cli/issues>
80
81 ## License
82
83 Apache-2.0
84
85 ## Copyright
86
87 © 2026 [Splitfire AB](https://5mb.app) ([smbCloud](https://smbcloud.xyz)).