cli

<p align="center">
  <h1 align="center">@sandbaseai/cli</h1>
  <p align="center">
    <strong>Give your AI agent superpowers. One command. 2,000+ AI models and APIs.</strong>
  </p>
  <p align="center">
    English | <a href="./README.zh-CN.md">中文</a> | <a href="./README.ja.md">日本語</a> | <a href="./README.ko.md">한국어</a> | <a href="./README.es.md">Español</a> | <a href="./README.fr.md">Français</a> | <a href="./README.de.md">Deutsch</a> | <a href="./README.pt-BR.md">Português</a>
  </p>
  <p align="center">
    <a href="https://github.com/sandbaseai/cli/releases/latest"><img alt="GitHub release" src="https://img.shields.io/github/v/release/sandbaseai/cli"></a>
    <a href="https://github.com/sandbaseai/cli/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/sandbaseai/cli/actions/workflows/ci.yml/badge.svg"></a>
    <a href="https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli"><img alt="Official MCP Registry" src="https://img.shields.io/badge/MCP%20Registry-listed-5a67d8"></a>
    <a href="https://tensorblock.co/mcp/servers/github-sandbaseai-cli-c4e113db"><img alt="Indexed on TensorBlock MCP Index" src="https://mcp-index.tensorblock.co/v1/servers/github-sandbaseai-cli-c4e113db/badge.svg"></a>
    <a href="https://github.com/sandbaseai/cli/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/sandbaseai/cli"></a>
    <a href="https://github.com/sandbaseai/cli/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/sandbaseai/cli?style=social"></a>
  </p>
</p>

<p align="center">
  <img src="https://raw.githubusercontent.com/sandbaseai/cli/main/.github/assets/sandbase-cli-hero.webp" alt="SandBase CLI connects AI clients to 2,000+ AI models and APIs" width="100%">
</p>

---

Your AI coding assistant is smart, but it's trapped in a box. It can't search the web, check social media, generate images, or access real-time data — unless you wire up each API yourself.

**SandBase changes that.** One command connects your agent to 2,000+ AI models and APIs through the [Model Context Protocol](https://modelcontextprotocol.io). No API keys to manage. No configuration headaches.

Building directly over HTTP instead of MCP? Start with the [SandBase API quickstart](https://www.sandbase.ai/docs/getting-started/)
or compare the unified [LLM, image, and video API](https://blog.sandbase.ai/unified-ai-api-llm-image-video-2026/)
with specialized model gateways.

```sh
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
```

Or install the official Homebrew formula on macOS or Linux:

```sh
brew install sandbaseai/tap/sandbaseai-cli
sandbase connect
```

See the [Homebrew launch announcement and macOS/Linux CI evidence](https://github.com/sandbaseai/cli/discussions/55).

For a reproducible install, verify the immutable release archive before
running it. The SHA-256 for `sandbaseai-cli-0.1.17.tgz` is
`1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`.

```sh
curl -fL -o sandbaseai-cli-0.1.17.tgz \
  https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz
echo '1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa  sandbaseai-cli-0.1.17.tgz' | shasum -a 256 -c -
npx -y ./sandbaseai-cli-0.1.17.tgz connect
```

Approve the browser authorization once; each supported client can then discover,
inspect, and run available SandBase models and APIs through the local MCP bridge.

Want to inspect compatibility before signing in or changing configuration? The current
[`v0.1.17` GitHub release](https://github.com/sandbaseai/cli/releases/tag/v0.1.17)
includes a verified 25-client catalog:

```sh
npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
```

Homebrew users can run the same read-only check with `sandbase catalog --json`.

The npm `latest` tag currently serves v0.1.14 while tokenless trusted publishing is
being enabled. The GitHub release tarball is built from the immutable `v0.1.17` tag;
its SHA-256 is published with the release.

Visit the [official SandBase CLI project page](https://sandbaseai.github.io/cli/) for a compact overview.
For a security-focused walkthrough of client detection, MCP tools, and rollback,
read the [25-client SandBase CLI setup guide](https://blog.sandbase.ai/sandbase-cli-mcp-bridge-25-ai-clients/).
AI agents and automated installers can use the concise
[`llms-install.md`](./llms-install.md) instructions.

## SandBase Open-Source Stack

- **[SandBase Harness](https://github.com/sandbaseai/sandbase-harness)** — self-hosted agent runtime with persistent sessions, sandbox isolation, approvals, audit, and replay.
- **[SandBase Agent Skills](https://github.com/sandbaseai/sandbase-skills)** — 88 installable Skills for research, social intelligence, marketing, and business workflows.
- **[SandBase for Codex](https://github.com/sandbaseai/sandbase-codex-plugin)** — official Codex plugin packaging the SandBase MCP bridge and guided Agent Skill; its required HOL security scan passes on `main`.

Discover the authenticated remote bridge in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli),
read its [Registry community showcase](https://github.com/modelcontextprotocol/registry/discussions/1584), or find it through
[Chinese Independent Developer](https://github.com/1c7/chinese-independent-developer/blob/master/pages/README-Programmer-Edition.md#sandbase---github),
[Awesome MCP](https://github.com/AlexMili/Awesome-MCP#ai-agents--memory),
[Glama](https://glama.ai/mcp/connectors/io.github.sandbaseai/cli),
[TensorBlock MCP Index](https://tensorblock.co/mcp/servers/github-sandbaseai-cli-c4e113db),
[MCPRepository](https://mcprepository.com/sandbaseai/cli),
[VaultPlane](https://www.vaultplane.com/server/sandbase-cli),
[AIMCP](https://www.aimcp.info/en/g/522d366e-114b-4d90-9f1a-552b4b3a9c86),
[MCP Server Hub](https://mcpserver.dev/s/sandbase-cli_r2sjd4x),
[MCP Server Spot](https://www.mcpserverspot.com/servers/sandbase-cli), or the
[Awesome AI API Proxy](https://github.com/howardpen9/awesome-ai-api-proxy#global-gateways--aggregators).
External maintainers have merged SandBase into
[Awesome Codex CLI](https://github.com/milisp/awesome-codex-cli/pull/110),
[Awesome Agent Skills](https://github.com/junminhong/awesome-agent-skills/pull/39), and
[Awesome MCP Server](https://github.com/AIAnytime/Awesome-MCP-Server/pull/70).
The Hermes integration is independently listed in the
[Hermes Atlas](https://github.com/ksimback/hermes-ecosystem) ecosystem catalog and as beta in
[Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent#integrations--bridges).
Install its
verified [`sandbase` Agent Skill from skills.sh](https://www.skills.sh/sandbaseai/cli/sandbase),
the [`sandbaseai/cli/sandbase` listing on SkillsCat](https://skills.cat/skills/sandbaseai/cli/sandbase),
the [`sandbaseai/cli/sandbase` listing on skills.re](https://skills.re/skills/sandbaseai/cli/sandbase),
the [93/100 verified SandBase listing on vSkill](https://verified-skill.com/skills/sandbaseai/cli/sandbase),
the [security-audited SandBase listing on Skillstore](https://skillstore.io/skills/sandbaseai-sandbase),
or the versioned [`sandbaseai/sandbase` snapshot on Agent Skill Hub](https://agentskillhub.dev/u/sandbaseai/sk/sandbase).

---

## A Verifiable Agent Workflow

After connecting, ask your agent to follow the same inspectable sequence for
search, data APIs, language models, image generation, video generation, and
other catalog capabilities:

1. Use `sandbase_discover` to find candidates by task or capability.
2. Use `sandbase_inspect` to read the current input schema, pricing, and
   execution requirements.
3. Confirm the selected endpoint, parameters, and possible cost before calling
   `sandbase_run`.
4. For asynchronous work, use `sandbase_run_get` with the returned `run_id`
   instead of creating a duplicate run.
5. Use `sandbase_runs` to review recent run status and recorded cost.
6. Use `sandbase_account` to check the current account balance.

For example, start with a non-billable discovery request:

> Find image models suitable for a square product illustration. Compare the
> required inputs and current pricing for the best two candidates. Do not run
> either model yet.

After reviewing the live response, explicitly approve the endpoint and inputs
you want to run. Catalog entries, schemas, pricing, latency, and availability
can change, so use the tool response from the current session rather than a
static example.

See the [complete Claude Code and Codex walkthrough](https://github.com/sandbaseai/cli/discussions/47)
or the [Chinese workflow guide](https://github.com/sandbaseai/cli/discussions/48).

---

## What's Inside

| Category | Tools | What You Can Do |
|----------|-------|-----------------|
| **Web Search** | Google, Exa, Tavily, Scholar | Research anything in real-time |
| **Social Media** | Twitter/X, YouTube, Reddit, Instagram, TikTok, Xiaohongshu, Weibo, Bilibili | Monitor trends, pull posts, analyze content |
| **Scraping** | Firecrawl, Exa Content | Extract data from any public webpage |
| **AI Models** | GPT-4o, Claude, Gemini, DeepSeek, Qwen, Llama | Run any model without managing keys |
| **Image Gen** | Flux, DALL-E, Ideogram, Recraft | Create logos, illustrations, mockups |
| **Video Gen** | Kling, MiniMax, Runway, Luma | Generate short clips and animations |
| **Audio** | ElevenLabs, Whisper | Text-to-speech, transcription |
| **E-commerce** | Taobao, Amazon | Product research, price comparison |
| **Finance** | Stock data, company info | Market research and analysis |

---

## Supported Clients (25 Targets)

Works with every major AI coding tool:

| Auto-configured | Manual setup |
|-----------------|--------------|
| Cursor, Cursor CLI | ChatGPT |
| Claude Code | Claude Desktop |
| Codex | |
| Kiro IDE, Kiro CLI | |
| Wi