# Vast.ai CLI and SDK

> Vast.ai's own skills for its CLI and Python SDK: your agent finds GPU offers, rents and manages instances, volumes and serverless endpoints.

Vast.ai's own Agent Skills teach your agent its GPU cloud's command line and Python SDK, so it can search the GPU marketplace, launch and manage instances, move files, and run serverless endpoints for you.

What its skills teach your agent
- vastai (CLI): search offers with filters and sorting (GPU model, count, VRAM, reliability, price, region), create instances from an image, poll until they're running, connect over SSH, copy files, read logs, and stop or destroy instances; plus interruptible (spot) rentals, volumes, serverless endpoints and deployments, templates, SSH keys, API keys, billing, teams, environment variables and machine hosting
- vastai-sdk (Python): the VastAI class for the same jobs in code, the low-level sync and async clients, and the Serverless client for sending requests to an inference endpoint

How it connects
- Install the vastai CLI (curl -fsSL https://vast.ai/install.sh | bash on Linux or macOS, or pip install vastai), then sign in once with vastai set api-key and a key from your Vast.ai console.
- Add the skills with npx skills add vast-ai/vast-cli. Vast.ai documents Claude Code, Cursor, Windsurf and Codex.
- The skill has your agent use --raw for JSON output it can read reliably.

Good to know
- Renting GPUs costs money. Storage is charged from creation and GPU time once an instance is running; the skill reminds your agent to destroy instances when done, and to time out polling loops so a stuck instance doesn't keep charging.
- Destroying an instance is permanent. Stopping keeps the disk without GPU charges.
- The CLI runs on Linux and macOS; on Windows use pip.

- Type: Skill
- Made by: vast-ai
- Category: Cloud & DevOps
- Formats: Skills
- Version: latest
- Website: https://vast.ai
- Source: https://github.com/vast-ai/vast-cli
- Page: https://pluginboard.ai/skills/vast-cli

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the vast-cli folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### Claude

In Claude (web or desktop): Download each skill’s folder and zip it, then upload them one at a time in Customize → Skills.

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### Gemini

In Gemini: Download the vast-cli folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### GitHub Copilot

Copy all 2 skills, in your terminal:

```shell
npx -y degit vast-ai/vast-cli/vastai ~/.copilot/skills/vastai
npx -y degit vast-ai/vast-cli/vastai_sdk ~/.copilot/skills/vastai_sdk
```

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### Cursor

Copy all 2 skills, in your terminal:

```shell
npx -y degit vast-ai/vast-cli/vastai ~/.cursor/skills/vastai
npx -y degit vast-ai/vast-cli/vastai_sdk ~/.cursor/skills/vastai_sdk
```

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### Claude Code

Copy all 2 skills, in your terminal:

```shell
npx -y degit vast-ai/vast-cli/vastai ~/.claude/skills/vastai
npx -y degit vast-ai/vast-cli/vastai_sdk ~/.claude/skills/vastai_sdk
```

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### Codex

Copy all 2 skills, in your terminal:

```shell
npx -y degit vast-ai/vast-cli/vastai ~/.agents/skills/vastai
npx -y degit vast-ai/vast-cli/vastai_sdk ~/.agents/skills/vastai_sdk
```

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### Antigravity

In Antigravity: Copy the vast-cli folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### Gemini CLI

Copy all 2 skills, in your terminal:

```shell
npx -y degit vast-ai/vast-cli/vastai ~/.gemini/skills/vastai
npx -y degit vast-ai/vast-cli/vastai_sdk ~/.gemini/skills/vastai_sdk
```

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### Replit

Copy all 2 skills, in your terminal:

```shell
npx -y degit vast-ai/vast-cli/vastai .agents/skills/vastai
npx -y degit vast-ai/vast-cli/vastai_sdk .agents/skills/vastai_sdk
```

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### OpenClaw

Copy all 2 skills, in your terminal:

```shell
npx -y degit vast-ai/vast-cli/vastai ~/.openclaw/skills/vastai
npx -y degit vast-ai/vast-cli/vastai_sdk ~/.openclaw/skills/vastai_sdk
```

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### OpenCode

Copy all 2 skills, in your terminal:

```shell
npx -y degit vast-ai/vast-cli/vastai ~/.config/opencode/skills/vastai
npx -y degit vast-ai/vast-cli/vastai_sdk ~/.config/opencode/skills/vastai_sdk
```

View the skills on GitHub: https://github.com/vast-ai/vast-cli

### Hermes Agent

Copy all 2 skills, in your terminal:

```shell
npx -y degit vast-ai/vast-cli/vastai ~/.hermes/skills/vastai
npx -y degit vast-ai/vast-cli/vastai_sdk ~/.hermes/skills/vastai_sdk
```

View the skills on GitHub: https://github.com/vast-ai/vast-cli

---
From Pluginboard (https://pluginboard.ai).
