sui-install

Fix Sui CLI installation and version mismatches with suiup commands.

10|5|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/MystenLabs/skills --skill sui-install
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sui-install
Source: https://github.com/MystenLabs/skills/tree/main/sui-install
Command: npx skills add https://github.com/MystenLabs/skills --skill sui-install

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sui CLI installation and version-management friction causes “command not found”, network/protocol build issues, and “client/server api version mismatch” warnings that block development and transactions.

Core Features & Use Cases

  • Install Sui toolchain with suiup: Set up the Sui CLI using the official suiup installer and manage network-targeted binaries.
  • Update and switch versions correctly: Perform the required two-step process (update downloads; switch activates) to align your local CLI with the network.
  • Troubleshoot common setup failures: Resolve version mismatches and missing command errors by verifying active defaults and installing optional tooling on demand (e.g., Walrus, MVR, Move Analyzer).

Quick Start

Tell the AI to install and activate the correct Sui CLI version for testnet using suiup, then verify it with sui --version.

Frequently Asked Questions about sui-install

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix the Sui CLI client/server api version mismatch warning?

Resolve the Sui CLI client/server api version mismatch by using suiup to update and switch to the correct network-specific binary, ensuring your local client version aligns with the target network protocol.

What is the correct process to switch Sui CLI versions between testnet and mainnet?

Switching Sui CLI versions requires a two-step process using suiup: first update to download the target binary, then switch using the binary@network syntax to activate it and verify the active default before proceeding.

Why does my terminal show 'sui: command not found' after installation?

The 'sui: command not found' error occurs when the Sui CLI binary is missing or not activated, requiring you to run the official suiup installer, execute the switch command, and verify the active default path.

Can I install optional Sui stack components like Walrus and Move Analyzer using suiup?

Yes, you can install optional Sui stack components like Walrus, MVR, and Move Analyzer on demand using suiup alongside the standard Sui CLI toolchain to support your specific Move tooling workflows.

How do I verify which Sui CLI network version is currently active?

Verify the active Sui CLI network version by running the sui --version command, which confirms the currently activated default binary and ensures it matches your target network requirements before executing transactions.