Near Cli Tools

# NEAR Tools - NEAR CLI Installation & Setup

> **CRITICAL FOR AGENTS:** Before calling any `near` command, you **MUST** find the absolute path of the `near` binary (e.g., using `which near` or `whereis near`) and use that absolute path in your commands. This ensures consistency across different shell environments.

This skill provides comprehensive guidance for installing and setting up the NEAR Protocol CLI (near-cli-rs) on any platform.

## Installation Methods

Choose the installation method that works best for your system:

### Option 1: Shell Script (Linux, macOS, WSL)

**Best for:** Most Linux and macOS users

```bash
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/near/near-cli-rs/releases/latest/download/near-cli-rs-installer.sh | sh
```

**if not add near to PATH:** 
find the near binary by `whereis near`

**Add to PATH:**

```bash
# Temporary (current session only)
export PATH="$HOME/.cargo/bin:$PATH"

# Permanent (add to your shell config)
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc  # For bash
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc   # For zsh
```

Reload your shell or run:
```bash
source ~/.bashrc   # or ~/.zshrc
```

### Option 2: npm/npx (Any Platform with Node.js)

**Best for:** JavaScript/TypeScript developers, Windows users

**Run directly without installation:**
```bash
npx near-cli-rs
```

**Install globally:**
```bash
npm install -g near-cli-rs
```

**Or add to package.json:**
```bash
npm install --save-dev near-cli-rs
```

Then use:
```bash
npx near-cli-rs
```

### Option 3: Windows Installer

**Best for:** Windows users without Node.js or Cargo

1. Visit: https://github.com/near/near-cli-rs/releases/latest
2. Download the Windows MSI installer (e.g., `near-cli-rs-installer-x64.msi`)
3. Double-click the installer and follow the wizard
4. The installer automatically adds NEAR CLI to your PATH

### Option 4: Cargo (Rust)

**Best for:** Rust developers, custom builds

**Prerequisites:** Install Rust first fr...

# near-tools — NEAR Protocol CLI Skill

> **Install and use the NEAR Protocol CLI (`near-cli-rs`) with OpenClaw AI agents**

## 🎯 What It Does

Helps AI agents install, configure, and use the NEAR CLI to interact with the NEAR Protocol blockchain:

- ✅ Multi-platform installation (Linux, macOS, Windows, WSL)
- ✅ Account management (view, create, import/export)
- ✅ Token operations (NEAR, FT, NFT)
- ✅ Staking management
- ✅ Smart contract deployment and interaction
- ✅ Transaction operations

## 📦 Installation

### For Users

No installation needed! This is a reference skill that provides installation instructions for the NEAR CLI itself.

### For AI Agents

**Critical**: Before calling any `near` command, agents MUST get the absolute path:

```bash
# Find the absolute path
which near
# or
whereis near

# Use the absolute path in commands
/root/.cargo/bin/near account view-account-summary cuongdcdev.near network-config mainnet now
```

## 🚀 Quick Start

### Install NEAR CLI

**Linux/macOS/WSL (recommended):**
```bash
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/near/near-cli-rs/releases/latest/download/near-cli-rs-installer.sh | sh
```

**npm/npx (any platform with Node.js):**
```bash
# Run without installing
npx near-cli-rs

# Or install globally
npm install -g near-cli-rs
```

**Windows:**
Download the MSI installer from [GitHub Releases](https://github.com/near/near-cli-rs/releases/latest)

### Verify Installation

```bash
near --version
# Expected: near-cli-rs 0.23.6 or newer
```

### View Account Balance

```bash
near account view-account-summary <account-id> network-config mainnet now

# Example
near account view-account-summary cuongdcdev.near network-config mainnet now
```

## 📖 Common Commands

### Account Operations
```bash
# View account details
near account view-account-summary <account-id> network-config mainnet now

# Import existing account
near account import-account

# Create new account
near account create-account

# Export acc...