@alpha-sdk/crsdk

Standalone CLI for the Sony Camera Remote SDK. Accept the EULA, extract the SDK zip, build the Sony-provided RemoteCli sample, and launch it — all from one command-line tool. Also installs MCP servers for the Sony SDK docs so coding agents (Claude Code, Cursor, VS Code) can answer SDK questions.

Install

npm install -g @alpha-sdk/crsdk

Quick start

crsdk doctor                                              # check toolchain
crsdk install --zip ~/Downloads/CrSDK_v2.01.00_Mac.zip    # accept EULA, extract
crsdk build                                               # build RemoteCli
crsdk launch                                              # interactive menu

Tip: commit cpp-sample/ to git after install. Your diff against the stock SDK is what you'll replay when porting to a future SDK version.

Commands

| Command | Description | | --- | --- | | crsdk help | Show command list | | crsdk doctor | Check toolchain + SDK state | | crsdk install --zip <path> | Accept EULA, extract Sony SDK zip into cpp-sample/ (first-time only) | | crsdk update --zip <path> | Swap in a newer SDK zip; auto-archives the previous one | | crsdk versions | List archived SDK versions | | crsdk use <archive-name> | Restore an archived SDK version into cpp-sample/ | | crsdk build [--clean] | Build Sony RemoteCli sample | | crsdk launch | Launch RemoteCli (interactive TTY) | | crsdk auth [login\|status\|logout] | Athena Bridge authentication (OAuth 2.1 + PKCE) | | crsdk athena-bridge [install\|status\|uninstall] <agent> <scope> | Install/remove Athena Bridge MCP | | crsdk mcp [status\|install <agent> <scope> [server\|--all]] | Manage C++ docs MCP servers |

SDK version management

install only stages a fresh SDK when no cpp-sample/ exists. To move between versions:

• crsdk update --zip <new.zip> — moves the current cpp-sample/ (with any edits) to sdk-archive/<old-version>/, then extracts the new zip into a clean cpp-sample/. Your edits are preserved in the archive; ask Athena to port them onto the new SDK.
• crsdk versions — list what's active and what's archived.
• crsdk use <archive-name> — swap an archived version back in (current tree gets archived first, so swaps are reversible).

Edits in cpp-sample/ are never wiped silently — install refuses if the directory exists, and update/use always archive before swapping.

Layout

crsdk-cli/
├── cpp-sample/               # active SDK — created by `crsdk install`
│   ├── app/                  # Sony sample source (RemoteCli)
│   ├── external/crsdk/       # Sony headers + dylibs
│   ├── CMakeLists.txt
│   └── build/                # created by `crsdk build` → RemoteCli binary
└── sdk-archive/              # created by first `crsdk update`
    └── v2.01.00/             # prior cpp-sample/, edits intact

macOS note

Sony's V2.01 macOS dylibs are ad-hoc signed. crsdk install strips com.apple.quarantine automatically. crsdk build repeats the clear as a safety net. If you ever copy dylibs in by hand and hit a Gatekeeper error:

xattr -dr com.apple.quarantine cpp-sample/

MCP servers

Installed into claude-code, vscode, or cursor via crsdk mcp install <agent> <scope> [server|--all]:

| Key | Description | Auth | | --- | --- | --- | | CameraRemoteSDK | C++/C# PTP SDK docs, API functions, code examples | none | | CameraHelp | Alpha / Cinema / PTZ camera help + compatibility | none | | AthenaBridge | Personalized SDK plans and bridge tools | crsdk auth login |

Athena Bridge is auth-gated and has its own surface:

crsdk auth login                                    # OAuth 2.1 + PKCE sign-in
crsdk athena-bridge install claude-code user        # writes MCP entry with Bearer token
crsdk athena-bridge status
crsdk athena-bridge uninstall claude-code user

Tokens are valid for 30 days — re-auth from the MCP prompt when they expire.

Getting the Sony SDK

Sony gates the SDK behind a contact form. Run crsdk install and press Enter at the prompt to see the download URL, or go directly to:

https://pro.sony/ue_US/digital-imaging/camera-remote-sdk-contact-us

Once you have the zip:

crsdk install --zip <path-to-zip>

EULA acceptance is recorded in .license-accepted so you only see the prompt once.

License

MIT