VIBE Skills & CLI

Overview

VIBE AI exposes its Web3 trading and data capabilities through three integration methods, letting any AI agent or developer access swap quotes, DeFi operations, token launches, and market data without building blockchain infrastructure from scratch.

Priority	Method	Best For	Setup
1	VIBE Skill	AI coding agents (Claude Code, Codex)	`npx skills add vibeAIrFORCE/vibe-skills --skill vibe`
2	VIBE CLI	Terminal workflows, scripting, automation	`pip install vibe-cli`
3	MCP Server	AI clients (Claude Desktop, Cursor, Windsurf)	JSON config

VIBE Skill (Recommended for AI Agents)

What It Does

The VIBE Skill teaches AI coding agents how to discover and call VIBE's Web3 operations. It handles:

Discovery: Find the right command for any request via vibe sync and vibe list-operations
Routing: Map natural language to the correct VIBE command
Auth handling: Try first, guide the user if credentials are needed
Error recovery: Handle rate limits, insufficient credits, and auth failures gracefully

Install

npx skills add vibeAIrFORCE/vibe-skills --skill vibe

Works with Claude Code, Codex, and any agent supporting the skills.sh protocol.

No API key needed to try -- you get 30 free credits per day. New accounts get additional free credits.

Available Skills

Skill	Scope	Description
`vibe`	Umbrella	Auth, envelope, discovery, LLM proxy
`vibe-data`	Data providers	Nansen, Blokiments, Twitter, social intelligence
`vibe-wallet`	Trading	Swap, DeFi deposit/withdraw operations
`vibe-bags`	Token launch	bags.fm token creation and fee claims
`vibe-twitter`	Social	38 Twitter/X API endpoints (read + write)
`vibe-defi`	DeFi	Staking, lending, liquidity provision
`vibe-trading`	Trading	Combined swap + quote operations
`vibe-x402`	Payments	x402 agent commerce protocol
`vibe-credits`	Billing	Credit balance and usage queries
`vibe-alpha`	Research	Alpha signals and market intelligence

Example Queries

"Swap 1 SOL to USDC"           → vibe swap-quote --from-token So1...11112 --to-token EPjF...Dt1v --amount 1000000000
"Get me a swap quote for BONK" → vibe swap-quote --from-token <SOL_MINT> --to-token <BONK_MINT> --amount <lamports>
"Stake 10 SOL on Marinade"     → vibe defi-quote --action stake --token SOL --amount 10 --protocol marinade
"Launch a token called DOGE2"  → vibe bags-launch-token --name "Doge 2" --symbol DOGE2 --description "..."
"Smart money flows on Base?"   → vibe data-provider --service nansen --route smart_money_netflows --payload '{"chains":["base"]}'
"Search Twitter for Ethereum"  → vibe data-provider --service twitter --route search --payload '{"query":"ethereum"}'

VIBE CLI

Install

# curl | sh (recommended)
curl -fsSL https://api.vibe.airforce/api/cli/install.sh | sh

# Or via pip
pip install vibe-cli

# Or via pipx (isolated)
pipx install vibe-cli

Authenticate

No API key required to try -- 30 free credits per day.

# Interactive (saves key permanently)
vibe auth

# Environment variable
export VIBE_API_KEY=pk_xxx:sk_xxx

Get your API key at vibe.airforce/settings/api-keys

Usage

# Discovery
vibe sync                                    # Fetch operations manifest
vibe list-operations                         # List all commands
vibe list-operations | grep swap             # Filter by keyword
vibe <command> --help                        # Full params and types

# Solana trading
vibe swap-quote --from-token <mint> --to-token <mint> --amount <lamports>
vibe swap --from-token <mint> --to-token <mint> --amount <lamports>

# EVM trading
vibe evm-swap-quote --network base --from-asset eth --to-asset usdc --amount 0.1
vibe evm-swap --network base --from-asset eth --to-asset usdc --amount 0.1

# DeFi
vibe defi-discover
vibe defi-quote --action stake --token SOL --amount 1.0
vibe defi-deposit --action stake --token SOL --amount 1.0

# bags.fm
vibe bags-launch-token --name "Token" --symbol TK --description "..." --image-url https://...
vibe bags-positions
vibe bags-claim-fees --token-mint <address>

# Data providers
vibe data-provider --service nansen --route smart_money_netflows --payload '{"chains":["base"]}'

Output Formats

# Table (default -- human-readable)
vibe swap-quote --from-token ... --to-token ... --amount 1000000

# JSON (structured)
vibe swap-quote -o json --from-token ... --to-token ... --amount 1000000

# Extract nested field (for agent consumption)
vibe swap-quote -o json -f body.data --from-token ... --to-token ... --amount 1000000

# Raw (unformatted JSON)
vibe swap-quote -o raw --from-token ... --to-token ... --amount 1000000

Best Practices

Pattern	Recommendation
Flags	Use kebab-case: `--from-token`, `--to-asset`, `--slippage-bps`
Amounts	Solana: lamports (1 SOL = 10^9), EVM: human-readable ("0.1")
Networks	Use canonical names: `base`, `ethereum`, `solana`
Discovery	Always `vibe sync` before first use in a session
Auth	`vibe auth` for persistent, or `VIBE_API_KEY` env var

API Reference

Base URL

Production: https://api.vibe.airforce
Staging: https://api-v3.vibe.airforce

All routes are under /api/vibe-tools/.

Authentication

Method	Header	Example
API Key (Bearer)	`Authorization: Bearer pk_xxx:sk_xxx`	CLI default
API Key (Header)	`X-API-Key: pk_xxx:sk_xxx`	Alternative
JWT	`Authorization: Bearer <jwt>`	Dashboard users
Trial Token	`Authorization: Bearer trial_xxx`	Free trial (30 req/day)

Response Envelope

All responses use a standardized envelope:

Success:

{
  "data": { ... },
  "meta": {
    "request_id": "uuid",
    "timestamp": "2026-04-16T12:00:00Z"
  }
}

Error:

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Try again in 30s.",
    "retry_after": 30
  },
  "meta": {
    "request_id": "uuid",
    "timestamp": "2026-04-16T12:00:00Z"
  }
}

Endpoints

Discovery

Method	Path	Scope	Description
GET	`/api/vibe-tools/operations`	`gateway:read`	Operations manifest
POST	`/api/vibe-tools/trial-auth`	None	Get free trial token

Data

Method	Path	Scope	Description
POST	`/api/vibe-tools/data-provider`	`gateway:data`	Query external data providers

Solana Trading

Method	Path	Scope	Description
POST	`/api/vibe-tools/swap-quote`	`gateway:data`	Get swap quote (Jupiter/Meteora)
POST	`/api/vibe-tools/swap`	`gateway:wallet_write`	Execute swap (unsigned tx)

EVM Trading

Method	Path	Scope	Description
POST	`/api/vibe-tools/evm/swap-quote`	`gateway:data`	Get swap quote (0x/CDP)
POST	`/api/vibe-tools/evm/swap`	`gateway:wallet_write`	Execute swap (CDP wallet)

DeFi

Method	Path	Scope	Description
POST	`/api/vibe-tools/defi/discover`	`gateway:data`	Discover DeFi protocols
POST	`/api/vibe-tools/defi/quote`	`gateway:data`	Get DeFi quote
POST	`/api/vibe-tools/defi/deposit`	`gateway:wallet_write`	Execute DeFi deposit (unsigned tx)

bags.fm

Method	Path	Scope	Description
POST	`/api/vibe-tools/bags/launch-token`	`gateway:wallet_write`	Launch token
POST	`/api/vibe-tools/bags/claim-fees`	`gateway:wallet_write`	Claim fees
GET	`/api/vibe-tools/bags/positions`	`gateway:data`	View positions

Credit Pricing

Per-Request Pricing

Tier	Price	Routes
Free	$0.00	`operations` (discovery), `trial-auth`
Light	$0.005	`swap-quote`, `evm/swap-quote`, `defi/discover`, `bags/positions`
Standard	$0.01	`data-provider`, `defi/quote`, `bags/claim-fees`
Heavy	$0.02	`swap`, `evm/swap`, `defi/deposit`
Premium	$0.05	`bags/launch-token`

Free Trial

30 requests/day without API key
Read-only scopes (gateway:read, gateway:data)
No trading operations (no gateway:wallet_write)
Trial tokens expire after 24 hours

Full Access

Create an API key at vibe.airforce/settings/api-keys:

Scope	Allows
`gateway:read`	Discovery and operations manifest
`gateway:data`	Quotes, market data, positions, data providers
`gateway:wallet_write`	Swaps, DeFi deposits, token launches, fee claims

Next: OpenClaw Sandbox →