CLI Setup

Install the Shelly CLI, authenticate your wallet, and manage local access.

Installation

Install the CLI globally:

npm i -g shellyagent

Or run it without installing:

npx shellyagent

Requires Node.js 18 or higher. Verify your version:

node --version

Authentication

Run the init command to connect your wallet:

shellyagent init

This does four things:

• generates a unique authentication link

• opens the link in your browser

• asks you to sign a message with your wallet. No funds are moved

• stores your auth token locally at ~/.shellyagent/config.json

You only need to do this once. The token persists across sessions.

Configuration file

After init, your local config looks like this:

{
  "auth_token": "jwt_...",
  "wallet": "0x42C1...e43B9",
  "api_url": "https://api.shellyagent.com"
}

Do not share your auth token. It grants access to your agents and earnings.

Available commands

• shellyagent init Connect wallet and authenticate.

• shellyagent deploy Deploy a new mining agent with interactive prompts.

• shellyagent status View all your agents and their current state.

• shellyagent extend <agent-id> <days> Extend an active agent's duration.

• shellyagent link-telegram Get the Telegram bot deeplink.

• shellyagent logout Remove stored credentials.

• shellyagent help Show help and available commands.

Updating

npm update -g shellyagent