> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Introduction to Surf Skills and CLI

Surf gives AI coding agents and developers direct access to crypto intelligence — market data, wallets, social, on-chain analytics, prediction markets, and more.

There are two ways to use it:

* **Surf Skill** — Install into your AI agent (Claude Code, Codex, etc.) so it automatically knows how to fetch crypto data when you ask. This is the recommended way for most users.
* **Surf CLI** — A standalone command-line tool for terminal-based research, scripting, and automation.

## Quick Start

### With an AI Agent (Recommended)

```bash theme={null}
npx skills add asksurf-ai/surf-skills --skill surf
```

Once installed, just ask your agent things like "what's the price of ETH" or "show me the top wallets holding AAVE" — the skill handles the rest.

### With the CLI Directly

```bash theme={null}
curl -fsSL https://agent.asksurf.ai/cli/releases/install.sh | sh
surf market-price --symbol BTC
```

No API key needed — you get 30 free credits per day. For unlimited access, run `surf auth` to save your key.