sui-client

Configure Sui CLI clients, manage environments and addresses, and diagnose gas-coin errors.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The skill removes friction when setting up and troubleshooting the Sui CLI by guiding users through client configuration, environment/address switching, token (gas) acquisition, and common recovery or gas-coin issues.

Core Features & Use Cases

  • Client configuration & networks: Create and manage client.yaml settings, switch between Mainnet/Testnet/Devnet/Localnet, and select active address.
  • Address, keys, and recovery: Generate local addresses, manage keystore locations, and recover an address from a recovery phrase.
  • Token acquisition & balance verification: Acquire SUI for gas via correct faucet methods per network, check balances, and diagnose gas coin availability errors.
  • Coin operations & transaction readiness: Merge coin objects using ptb to resolve “Cannot find gas coin for signer address” scenarios; inspect gas coin objects for troubleshooting.
  • Explorers & troubleshooting context: Use SuiVision/Suiscan for inspecting transactions/objects and use replay for debugging past transactions.

Quick Start

Use the sui-client skill when the user asks for help configuring Sui CLI, switching networks/addresses, obtaining faucet tokens, recovering keys, merging coins for gas, or resolving gas coin errors, by directing the model to explain the correct sui client commands and faucet/network rules for the user’s situation.

Frequently Asked Questions about sui-client

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

FAQPage Schema
How do I configure the Sui CLI client and switch between Mainnet, Testnet, Devnet, and Localnet?

To configure the Sui CLI, you manage client.yaml settings to switch between Mainnet, Testnet, Devnet, and Localnet, and select your active address. This setup ensures your CLI environment targets the correct network for transactions.

Why does my Sui CLI transaction fail with Cannot find gas coin for signer address?

The "Cannot find gas coin for signer address" error indicates fragmented or unavailable gas coins. You resolve this by inspecting gas coin objects and merging coin objects using ptb, the preferred CLI transaction path, to consolidate gas for transactions.

How do I get SUI faucet tokens for gas on Testnet and Devnet?

To get SUI faucet tokens for gas, you must use correct faucet methods per network while avoiding unsafe faucet suggestions across networks. The Sui CLI directs you to acquire SUI tokens and verify balances for transactions.

How can I recover a Sui address from a recovery phrase using the CLI?

To recover a Sui address from a recovery phrase, you use the Sui CLI to manage keystore locations and generate local addresses. This key recovery process restores access to your addresses for signing transactions.

What is the best way to inspect Sui transaction data and debug past transactions?

The best way to inspect Sui transaction data and debug past transactions is using SuiVision or Suiscan explorers to examine objects, and using replay for debugging. This provides visibility into transaction readiness and troubleshooting context.