@sandbaseai/cli 0.1.14 → 0.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,11 +1,382 @@
1
- # @sandbaseai/cli
1
+ <p align="center">
2
+ <h1 align="center">@sandbaseai/cli</h1>
3
+ <p align="center">
4
+ <strong>Give your AI agent superpowers. One command. 2,000+ AI models and APIs.</strong>
5
+ </p>
6
+ <p align="center">
7
+ 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>
8
+ </p>
9
+ <p align="center">
10
+ <a href="https://github.com/sandbaseai/cli/releases/latest"><img alt="GitHub release" src="https://img.shields.io/github/v/release/sandbaseai/cli"></a>
11
+ <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>
12
+ <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>
13
+ <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>
14
+ <a href="https://github.com/sandbaseai/cli/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/github/license/sandbaseai/cli"></a>
15
+ <a href="https://github.com/sandbaseai/cli/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/sandbaseai/cli?style=social"></a>
16
+ </p>
17
+ </p>
2
18
 
3
- Node.js 20+ CLI for securely connecting Codex, Claude Code, Cursor, or Hermes to SandBase MCP.
19
+ <p align="center">
20
+ <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%">
21
+ </p>
22
+
23
+ ---
24
+
25
+ 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.
26
+
27
+ **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.
28
+
29
+ Building directly over HTTP instead of MCP? Start with the [SandBase API quickstart](https://www.sandbase.ai/docs/getting-started/)
30
+ or compare the unified [LLM, image, and video API](https://blog.sandbase.ai/unified-ai-api-llm-image-video-2026/)
31
+ with specialized model gateways.
32
+
33
+ ```sh
34
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
35
+ ```
36
+
37
+ Or install the official Homebrew formula on macOS or Linux:
38
+
39
+ ```sh
40
+ brew install sandbaseai/tap/sandbaseai-cli
41
+ sandbase connect
42
+ ```
43
+
44
+ See the [Homebrew launch announcement and macOS/Linux CI evidence](https://github.com/sandbaseai/cli/discussions/55).
45
+
46
+ For a reproducible install, verify the immutable release archive before
47
+ running it. The SHA-256 for `sandbaseai-cli-0.1.17.tgz` is
48
+ `1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`.
49
+
50
+ ```sh
51
+ curl -fL -o sandbaseai-cli-0.1.17.tgz \
52
+ https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz
53
+ echo '1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa sandbaseai-cli-0.1.17.tgz' | shasum -a 256 -c -
54
+ npx -y ./sandbaseai-cli-0.1.17.tgz connect
55
+ ```
56
+
57
+ Approve the browser authorization once; each supported client can then discover,
58
+ inspect, and run available SandBase models and APIs through the local MCP bridge.
59
+
60
+ Want to inspect compatibility before signing in or changing configuration? The current
61
+ [`v0.1.17` GitHub release](https://github.com/sandbaseai/cli/releases/tag/v0.1.17)
62
+ includes a verified 25-client catalog:
63
+
64
+ ```sh
65
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
66
+ ```
67
+
68
+ <p align="center">
69
+ <a href="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/catalog-audit-5eea5978a1ed.webp"><img src="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/catalog-audit-5eea5978a1ed.webp" alt="Read-only SandBase CLI v0.1.17 catalog audit showing 25 client targets" width="49%"></a>
70
+ <a href="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/doctor-readback-3c86ac73e463.webp"><img src="https://static.sandbase.ai/blog/screenshots/sandbase-cli-mcp-bridge-25-ai-clients/doctor-readback-3c86ac73e463.webp" alt="SandBase CLI v0.1.17 doctor failing closed for an empty isolated profile" width="49%"></a>
71
+ </p>
72
+ <p align="center"><sub>Evidence captured from the immutable v0.1.17 release: a no-write catalog audit and a bounded doctor check against an empty isolated profile.</sub></p>
73
+
74
+ Homebrew users can run the same read-only check with `sandbase catalog --json`.
75
+
76
+ The npm `latest` tag currently serves v0.1.14 while tokenless trusted publishing is
77
+ being enabled. The GitHub release tarball is built from the immutable `v0.1.17` tag;
78
+ its SHA-256 is published with the release.
79
+
80
+ Visit the [official SandBase CLI project page](https://sandbaseai.github.io/cli/) for a compact overview.
81
+ For a security-focused walkthrough of client detection, MCP tools, and rollback,
82
+ read the [25-client SandBase CLI setup guide](https://blog.sandbase.ai/sandbase-cli-mcp-bridge-25-ai-clients/).
83
+ AI agents and automated installers can use the concise
84
+ [`llms-install.md`](./llms-install.md) instructions.
85
+
86
+ ## SandBase Open-Source Stack
87
+
88
+ - **[SandBase Harness](https://github.com/sandbaseai/sandbase-harness)** — self-hosted agent runtime with persistent sessions, sandbox isolation, approvals, audit, and replay.
89
+ - **[SandBase Agent Skills](https://github.com/sandbaseai/sandbase-skills)** — 88 installable Skills for research, social intelligence, marketing, and business workflows.
90
+ - **[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`.
91
+
92
+ Discover the authenticated remote bridge in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli),
93
+ read its [Registry community showcase](https://github.com/modelcontextprotocol/registry/discussions/1584), or find it through
94
+ [Chinese Independent Developer](https://github.com/1c7/chinese-independent-developer/blob/master/pages/README-Programmer-Edition.md#sandbase---github),
95
+ [Awesome MCP](https://github.com/AlexMili/Awesome-MCP#ai-agents--memory),
96
+ [Glama](https://glama.ai/mcp/connectors/io.github.sandbaseai/cli),
97
+ [TensorBlock MCP Index](https://tensorblock.co/mcp/servers/github-sandbaseai-cli-c4e113db),
98
+ [MCPRepository](https://mcprepository.com/sandbaseai/cli),
99
+ [VaultPlane](https://www.vaultplane.com/server/sandbase-cli),
100
+ [AIMCP](https://www.aimcp.info/en/g/522d366e-114b-4d90-9f1a-552b4b3a9c86),
101
+ [MCP Server Hub](https://mcpserver.dev/s/sandbase-cli_r2sjd4x),
102
+ [MCP Server Spot](https://www.mcpserverspot.com/servers/sandbase-cli), or the
103
+ [Awesome AI API Proxy](https://github.com/howardpen9/awesome-ai-api-proxy#global-gateways--aggregators).
104
+ External maintainers have merged SandBase into
105
+ [Awesome Codex CLI](https://github.com/milisp/awesome-codex-cli/pull/110),
106
+ [Awesome Agent Skills](https://github.com/junminhong/awesome-agent-skills/pull/39), and
107
+ [Awesome MCP Server](https://github.com/AIAnytime/Awesome-MCP-Server/pull/70).
108
+ The Hermes integration is independently listed in the
109
+ [Hermes Atlas](https://github.com/ksimback/hermes-ecosystem) ecosystem catalog and as beta in
110
+ [Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent#integrations--bridges).
111
+ Install its
112
+ verified [`sandbase` Agent Skill from skills.sh](https://www.skills.sh/sandbaseai/cli/sandbase),
113
+ the [`sandbaseai/cli/sandbase` listing on SkillsCat](https://skills.cat/skills/sandbaseai/cli/sandbase),
114
+ the [`sandbaseai/cli/sandbase` listing on skills.re](https://skills.re/skills/sandbaseai/cli/sandbase),
115
+ the [93/100 verified SandBase listing on vSkill](https://verified-skill.com/skills/sandbaseai/cli/sandbase),
116
+ the [security-audited SandBase listing on Skillstore](https://skillstore.io/skills/sandbaseai-sandbase),
117
+ or the versioned [`sandbaseai/sandbase` snapshot on Agent Skill Hub](https://agentskillhub.dev/u/sandbaseai/sk/sandbase).
118
+
119
+ ---
120
+
121
+ ## A Verifiable Agent Workflow
122
+
123
+ After connecting, ask your agent to follow the same inspectable sequence for
124
+ search, data APIs, language models, image generation, video generation, and
125
+ other catalog capabilities:
126
+
127
+ 1. Use `sandbase_discover` to find candidates by task or capability.
128
+ 2. Use `sandbase_inspect` to read the current input schema, pricing, and
129
+ execution requirements.
130
+ 3. Confirm the selected endpoint, parameters, and possible cost before calling
131
+ `sandbase_run`.
132
+ 4. For asynchronous work, use `sandbase_run_get` with the returned `run_id`
133
+ instead of creating a duplicate run.
134
+ 5. Use `sandbase_runs` to review recent run status and recorded cost.
135
+ 6. Use `sandbase_account` to check the current account balance.
136
+
137
+ For example, start with a non-billable discovery request:
138
+
139
+ > Find image models suitable for a square product illustration. Compare the
140
+ > required inputs and current pricing for the best two candidates. Do not run
141
+ > either model yet.
142
+
143
+ After reviewing the live response, explicitly approve the endpoint and inputs
144
+ you want to run. Catalog entries, schemas, pricing, latency, and availability
145
+ can change, so use the tool response from the current session rather than a
146
+ static example.
147
+
148
+ See the [complete Claude Code and Codex walkthrough](https://github.com/sandbaseai/cli/discussions/47)
149
+ or the [Chinese workflow guide](https://github.com/sandbaseai/cli/discussions/48). For a live
150
+ catalog example, read the [GitHub connector discover-and-inspect dogfooding note](https://github.com/sandbaseai/cli/discussions/57).
151
+
152
+ ---
153
+
154
+ ## What's Inside
155
+
156
+ | Category | Tools | What You Can Do |
157
+ |----------|-------|-----------------|
158
+ | **Web Search** | Google, Exa, Tavily, Scholar | Research anything in real-time |
159
+ | **Social Media** | Twitter/X, YouTube, Reddit, Instagram, TikTok, Xiaohongshu, Weibo, Bilibili | Monitor trends, pull posts, analyze content |
160
+ | **Scraping** | Firecrawl, Exa Content | Extract data from any public webpage |
161
+ | **AI Models** | GPT-4o, Claude, Gemini, DeepSeek, Qwen, Llama | Run any model without managing keys |
162
+ | **Image Gen** | Flux, DALL-E, Ideogram, Recraft | Create logos, illustrations, mockups |
163
+ | **Video Gen** | Kling, MiniMax, Runway, Luma | Generate short clips and animations |
164
+ | **Audio** | ElevenLabs, Whisper | Text-to-speech, transcription |
165
+ | **E-commerce** | Taobao, Amazon | Product research, price comparison |
166
+ | **Finance** | Stock data, company info | Market research and analysis |
167
+
168
+ ---
169
+
170
+ ## Supported Clients (25 Targets)
171
+
172
+ Works with every major AI coding tool:
173
+
174
+ | Auto-configured | Manual setup |
175
+ |-----------------|--------------|
176
+ | Cursor, Cursor CLI | ChatGPT |
177
+ | Claude Code | Claude Desktop |
178
+ | Codex | |
179
+ | Kiro IDE, Kiro CLI | |
180
+ | Windsurf | |
181
+ | Gemini CLI | |
182
+ | Amp | |
183
+ | Warp | |
184
+ | OpenCode, Qwen Code, Kimi CLI | |
185
+ | Hermes, OpenClaw | |
186
+
187
+ Preview the complete compatibility catalog without signing in or changing any files:
4
188
 
5
189
  ```sh
6
- npx -y @sandbaseai/cli connect --client codex
7
- sandbase doctor --client codex
8
- sandbase unregister --client codex
190
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
9
191
  ```
10
192
 
11
- The CLI opens the SandBase authorization page. Secrets are never included in command-line arguments or browser URLs. `SANDBASE_API_URL` may override the API origin for development and tests.
193
+ ```sh
194
+ # Connect all detected clients at once
195
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
196
+
197
+ # Or target one specific client
198
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
199
+ ```
200
+
201
+ ### OpenClaw quickstart
202
+
203
+ Target OpenClaw directly, then ask the CLI to read back the managed MCP server
204
+ and SandBase Skill before you rely on them:
205
+
206
+ ```sh
207
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client openclaw
208
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client openclaw
209
+ ```
210
+
211
+ After `doctor` reports the credential, MCP bridge, and Skill as configured,
212
+ restart OpenClaw and make a natural-language request that needs SandBase. If
213
+ OpenClaw already has a non-SandBase MCP server named `sandbase`, the installer
214
+ leaves it untouched instead of overwriting it. To remove the managed MCP entry
215
+ and local credential later:
216
+
217
+ ```sh
218
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client openclaw
219
+ ```
220
+
221
+ OpenClaw currently exposes no supported Skill removal command, so `unregister`
222
+ reports that limitation and leaves the verified SandBase Skill installed.
223
+
224
+ ### Hermes quickstart
225
+
226
+ SandBase can install both its managed Hermes Skill and local MCP entry in one
227
+ authorization transaction:
228
+
229
+ ```sh
230
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client hermes
231
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz doctor --client hermes
232
+ ```
233
+
234
+ `doctor` verifies the owned local credential, MCP entry, and Skill. Restart
235
+ Hermes to confirm native discovery in a fresh client session, then use the
236
+ SandBase Skill or MCP tools. A pre-existing, non-SandBase MCP entry named
237
+ `sandbase` is left untouched. To remove only the managed Hermes configuration,
238
+ Skill, and local credential while retaining the shared bridge for other clients:
239
+
240
+ ```sh
241
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz unregister --client hermes
242
+ ```
243
+
244
+ The integration is independently listed by
245
+ [Hermes Atlas](https://github.com/ksimback/hermes-ecosystem) and
246
+ [Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent#integrations--bridges).
247
+
248
+ ---
249
+
250
+ ## How It Works
251
+
252
+ ```
253
+ ┌─────────────────┐ ┌───────────────┐ ┌────────────────────┐
254
+ │ Your Agent │ MCP │ Local Bridge │ HTTPS │ SandBase API │
255
+ │ (Cursor, etc.) │────────▶│ (on-demand) │────────▶│ 2,000+ models/APIs │
256
+ │ │◀────────│ │◀────────│ │
257
+ └─────────────────┘ └───────────────┘ └────────────────────┘
258
+ ```
259
+
260
+ 1. Run `connect` → CLI opens browser auth → you approve
261
+ 2. API key saved locally (file permissions `0600`)
262
+ 3. MCP bridge configured for your client
263
+ 4. Agent calls tools on-demand. No daemon. No background process.
264
+
265
+ ---
266
+
267
+ ## Commands
268
+
269
+ ### CLI Commands
270
+
271
+ ```sh
272
+ sandbase connect [--client <name>] # Authorize + configure
273
+ sandbase setup # After upgrading: refresh the local bridge + Skill, test connectivity
274
+ sandbase doctor [--client <name>] # Local checks plus one real round trip to SandBase
275
+ sandbase unregister [--client <name>] # Remove configuration
276
+ sandbase catalog --json # List all supported clients
277
+ ```
278
+
279
+ ### Agent Commands (shell transport, same capabilities as the MCP tools)
280
+
281
+ Agents without MCP, or with a broken MCP session, use the same catalog from a shell. Credentials come from `connect` automatically (or `SANDBASE_API_KEY` / `sandbase keys add -k <key>`).
282
+
283
+ ```sh
284
+ sandbase discover -q "twitter posts" # search; -t api|llm|multimodal|embedding|service
285
+ sandbase inspect sandbase_twitter_web_search_timeline # fields, price, ready-to-run command
286
+ sandbase run sandbase_twitter_web_search_timeline -i '{"keyword":"AI agents"}'
287
+ sandbase run <video_tool> -i '{"prompt":"..."}' -w -o result.json # wait with backoff, save output to disk
288
+ sandbase runs get -r <run_id> -w -o result.json # resume a long run instead of re-running it
289
+ sandbase upload ./photo.png # local image/audio/video -> public URL for tools that take a URL
290
+ sandbase runs list | sandbase balance
291
+ ```
292
+
293
+ `-j` prints JSON; errors are `{"error":{"code","message","hint"}}` with the next step in `hint`. Exit codes: `0` success or still running, `1` failure (including a failed run), `2` usage.
294
+
295
+ Sync tools (LLMs, most data APIs) return their result directly; async tools (image, video, audio jobs) return a run id — wait with `-w`, or fetch later with `sandbase runs get -r <run_id>`. If `api.sandbase.ai` is unreachable, the bridge keeps the SandBase tools visible with an actionable error instead of dropping the server.
296
+
297
+ ### MCP Tools (available to your agent after connecting)
298
+
299
+ | Tool | Purpose |
300
+ |------|---------|
301
+ | `sandbase_discover` | Search all 2,000+ available AI models and APIs |
302
+ | `sandbase_inspect` | Get input schema, pricing, and ready-to-use template |
303
+ | `sandbase_run` | Execute a model or API endpoint |
304
+ | `sandbase_run_get` | Poll status/result of an async run (video gen, etc.) |
305
+ | `sandbase_runs` | List your recent API calls with cost breakdown |
306
+ | `sandbase_account` | Check account balance (free, no cost) |
307
+
308
+ **Recommended workflow:**
309
+
310
+ ```
311
+ discover → inspect → run
312
+ ```
313
+
314
+ ```
315
+ 1. sandbase_discover(q: "twitter search") → find current candidates
316
+ 2. sandbase_inspect(name: discovered_name) → get schema and pricing
317
+ 3. sandbase_run(name: discovered_name, input: {...}) → run after confirmation
318
+ ```
319
+
320
+ ---
321
+
322
+ ## Security
323
+
324
+ - **Zero secrets in URLs or CLI args** — OAuth device flow with PKCE
325
+ - **Restricted file permissions** — Credentials stored with `0600`
326
+ - **Ownership-aware updates** — Existing JSONC comments and user-managed MCP entries are preserved
327
+ - **Exact rollback** — On failure or `unregister`, only configuration owned by SandBase is removed
328
+ - **Revoke anytime** — One click in the [SandBase Dashboard](https://sandbase.ai/console/keys)
329
+
330
+ ---
331
+
332
+ ## Get Started
333
+
334
+ ```sh
335
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
336
+ ```
337
+
338
+ Then ask your agent to do something it couldn't before.
339
+
340
+ **[Create a free account →](https://sandbase.ai)**
341
+
342
+ If SandBase saves you setup time, [star the repository](https://github.com/sandbaseai/cli) — it helps more agent users discover the project.
343
+
344
+ ---
345
+
346
+ ## Links
347
+
348
+ - [SandBase Platform](https://sandbase.ai)
349
+ - [Documentation](https://www.sandbase.ai/docs/)
350
+ - [CLI setup guide](https://www.sandbase.ai/docs/setup/cli)
351
+ - CLI deep dive: [English](https://blog.sandbase.ai/sandbase-cli-mcp-bridge-25-ai-clients/) · [中文](https://blog.sandbase.ai/zh-CN/sandbase-cli-mcp-bridge-25-ai-clients/)
352
+ - Six-tool practical workflow: [English](https://github.com/sandbaseai/cli/discussions/47) · [中文](https://github.com/sandbaseai/cli/discussions/48)
353
+ - [npm Package](https://www.npmjs.com/package/@sandbaseai/cli)
354
+ - [Official Codex Plugin](https://github.com/sandbaseai/sandbase-codex-plugin)
355
+ - [Dashboard](https://sandbase.ai/console)
356
+
357
+ ## Community
358
+
359
+ - [Ask a question or share what you built](https://github.com/sandbaseai/cli/discussions)
360
+ - [Report a reproducible bug](https://github.com/sandbaseai/cli/issues/new?template=bug-report.yml)
361
+ - [Propose an integration or improvement](https://github.com/sandbaseai/cli/issues/new?template=feature-request.yml)
362
+ - [Contribute to SandBase CLI](./CONTRIBUTING.md)
363
+
364
+ Community-curated listings:
365
+
366
+ - [Official Registry community showcase](https://github.com/modelcontextprotocol/registry/discussions/1584)
367
+ - [VaultPlane MCP directory](https://www.vaultplane.com/server/sandbase-cli)
368
+ - [AIMCP directory](https://www.aimcp.info/en/g/522d366e-114b-4d90-9f1a-552b4b3a9c86)
369
+ - [Awesome MCP](https://github.com/AlexMili/Awesome-MCP)
370
+ - [Awesome AI API Proxy](https://github.com/howardpen9/awesome-ai-api-proxy)
371
+ - [Awesome Gemini CLI](https://github.com/Piebald-AI/awesome-gemini-cli)
372
+ - [Hermes Atlas](https://github.com/ksimback/hermes-ecosystem)
373
+ - [Awesome Hermes Agent](https://github.com/0xNyk/awesome-hermes-agent)
374
+ - [Awesome AI Tools](https://github.com/QAInsights/awesome-ai-tools)
375
+ - [Awesome MCP Server](https://github.com/AIAnytime/Awesome-MCP-Server)
376
+ - [Awesome Agent Cortex](https://github.com/0xNyk/awesome-agent-cortex)
377
+ - [Awesome AI Agent Tools](https://github.com/michielhdoteth/awesome-ai-agent-tools)
378
+ - [Awesome Codex CLI](https://github.com/milisp/awesome-codex-cli)
379
+
380
+ ## License
381
+
382
+ Apache-2.0
@@ -0,0 +1,146 @@
1
+ <p align="center">
2
+ <h1 align="center">@sandbaseai/cli</h1>
3
+ <p align="center">
4
+ <strong>Dê superpoderes ao seu agente de IA. Um comando. 2.000+ modelos de IA e APIs.</strong>
5
+ </p>
6
+ <p align="center">
7
+ <a href="./README.md">English</a> | <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> | Português
8
+ </p>
9
+ <p align="center">
10
+ <a href="https://github.com/sandbaseai/cli/releases/latest"><img alt="Versão do GitHub" src="https://img.shields.io/github/v/release/sandbaseai/cli"></a>
11
+ <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>
12
+ <a href="https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.sandbaseai%2Fcli"><img alt="Registro MCP oficial" src="https://img.shields.io/badge/MCP%20Registry-listed-5a67d8"></a>
13
+ <a href="https://github.com/sandbaseai/cli/blob/main/LICENSE"><img alt="Licença" src="https://img.shields.io/github/license/sandbaseai/cli"></a>
14
+ <a href="https://github.com/sandbaseai/cli/stargazers"><img alt="GitHub Stars" src="https://img.shields.io/github/stars/sandbaseai/cli?style=social"></a>
15
+ </p>
16
+ </p>
17
+
18
+ <p align="center">
19
+ <img src="https://raw.githubusercontent.com/sandbaseai/cli/main/.github/assets/sandbase-cli-hero.webp" alt="SandBase CLI MCP bridge" width="100%">
20
+ </p>
21
+
22
+ ---
23
+
24
+ Seu assistente de codificação IA é inteligente, mas está preso em uma caixa. Ele não consegue pesquisar na web, verificar redes sociais, gerar imagens ou acessar dados em tempo real — a menos que você conecte cada API manualmente.
25
+
26
+ **SandBase muda isso.** Um comando conecta seu agente a 2.000+ modelos de IA e APIs pelo [MCP](https://modelcontextprotocol.io). Sem gerenciar chaves de API. Sem dor de cabeça.
27
+
28
+ ```sh
29
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
30
+ ```
31
+
32
+ Ou instale a fórmula oficial do Homebrew no macOS ou Linux:
33
+
34
+ ```sh
35
+ brew install sandbaseai/tap/sandbaseai-cli
36
+ sandbase connect
37
+ ```
38
+
39
+ É isso. Seu agente agora tem acesso a tudo.
40
+
41
+ ## Stack open source da SandBase
42
+
43
+ - **[SandBase Harness](https://github.com/sandbaseai/sandbase-harness)** — runtime de agentes auto-hospedado com sessões persistentes, isolamento, aprovações, auditoria e replay.
44
+ - **[SandBase Agent Skills](https://github.com/sandbaseai/sandbase-skills)** — 88 Skills instaláveis para pesquisa, inteligência social, marketing e fluxos de negócios.
45
+
46
+ ---
47
+
48
+ ## Fluxo de agente verificável
49
+
50
+ Depois de conectar, peça ao agente para seguir esta sequência auditável:
51
+
52
+ 1. Use `sandbase_discover` para encontrar modelos ou APIs adequados.
53
+ 2. Use `sandbase_inspect` para revisar o esquema de entrada, os preços atuais e os requisitos.
54
+ 3. Confirme o endpoint, os parâmetros e o possível custo antes de chamar `sandbase_run`.
55
+ 4. Para tarefas assíncronas, consulte `sandbase_run_get` com o `run_id` retornado.
56
+ 5. Use `sandbase_runs` para revisar o status e o custo registrado das execuções recentes.
57
+ 6. Use `sandbase_account` para verificar o saldo atual.
58
+
59
+ Comece, por exemplo, com uma solicitação de descoberta não faturável:
60
+
61
+ > Encontre modelos de imagem adequados para uma ilustração quadrada de produto. Compare as entradas e os preços atuais dos dois melhores candidatos. Não execute nenhum deles ainda.
62
+
63
+ Catálogo, preços, latência e disponibilidade podem mudar. Use a resposta atual das ferramentas em vez de valores estáticos de exemplo.
64
+
65
+ ---
66
+
67
+ ## Clientes compatíveis (25 destinos)
68
+
69
+ | Configuração automática | Configuração manual |
70
+ |------------------------|---------------------|
71
+ | Cursor, Claude Code, Codex | ChatGPT |
72
+ | Kiro IDE, Kiro CLI, Windsurf | Claude Desktop |
73
+ | Gemini CLI, Amp, Warp | |
74
+ | OpenCode, Qwen Code, Kimi CLI | |
75
+ | Hermes, OpenClaw | |
76
+
77
+ Quer verificar a compatibilidade antes de entrar ou alterar a configuração local? Execute o catálogo somente leitura para confirmar os 25 clientes compatíveis:
78
+
79
+ ```sh
80
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz catalog --json
81
+ ```
82
+
83
+ Esse comando usa o arquivo imutável da versão `v0.1.17` no GitHub. SHA-256:
84
+ `1ad535b2899ca460b57b3c268aef278fee28fd28e649a89b92951514fd71fffa`
85
+
86
+ A tag `latest` do npm ainda aponta para a v0.1.14; até a ativação do Trusted Publishing, use a URL versionada do GitHub acima.
87
+
88
+ ```sh
89
+ # Conectar todos os clientes detectados
90
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
91
+
92
+ # Ou um cliente específico
93
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect --client cursor
94
+ ```
95
+
96
+ ---
97
+
98
+ ## Comandos
99
+
100
+ ```sh
101
+ sandbase connect [--client <name>] # Autorizar + configurar
102
+ sandbase doctor [--client <name>] # Verificação de saúde
103
+ sandbase unregister [--client <name>] # Remover configuração
104
+ sandbase catalog --json # Listar clientes suportados
105
+ ```
106
+
107
+ ### Ferramentas MCP (disponíveis após conexão)
108
+
109
+ | Ferramenta | Propósito |
110
+ |------------|-----------|
111
+ | `sandbase_discover` | Pesquisar entre 2.000+ modelos e APIs |
112
+ | `sandbase_inspect` | Obter schema, preços e template |
113
+ | `sandbase_run` | Executar um modelo ou API |
114
+ | `sandbase_run_get` | Verificar status de tarefas assíncronas |
115
+ | `sandbase_runs` | Ver chamadas recentes e custos |
116
+ | `sandbase_account` | Verificar saldo (grátis) |
117
+
118
+ ---
119
+
120
+ ## Segurança
121
+
122
+ - **Zero segredos em URLs ou argumentos** — OAuth device flow + PKCE
123
+ - **Permissões de arquivo restritas** — Credenciais com `0600`
124
+ - **Rollback automático** — Se algo falhar, tudo é revertido
125
+ - **Revogar a qualquer momento** — [Dashboard SandBase](https://sandbase.ai/console/keys)
126
+
127
+ ---
128
+
129
+ ## Começar
130
+
131
+ ```sh
132
+ npx -y https://github.com/sandbaseai/cli/releases/download/v0.1.17/sandbaseai-cli-0.1.17.tgz connect
133
+ ```
134
+
135
+ **[Criar conta grátis →](https://sandbase.ai)**
136
+
137
+ Se o SandBase economizou seu tempo de configuração, [dê uma estrela ao projeto](https://github.com/sandbaseai/cli). Isso ajuda mais usuários de agentes a encontrá-lo.
138
+
139
+ ## Guia prático
140
+
141
+ - [Claude Code e Codex: descobrir, conferir o preço e executar](https://github.com/sandbaseai/cli/discussions/54)
142
+ - [Registro MCP oficial](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.sandbaseai%2Fcli/versions/0.1.17)
143
+
144
+ ## Licença
145
+
146
+ Apache-2.0