feat: add crabbox to box docs

box/guides/crabbox-setup.mdx

@@ -0,0 +1,66 @@
+---
+title: "Running Tests with Crabbox"
+---
+
+[Crabbox](https://crabbox.sh) is a CLI tool that runs commands inside a remote box from your local machine. This guide shows how to use it with Upstash Box to run your test suite in a clean cloud environment without touching your local setup.
+
+---
+
+## 1. Install Crabbox
+
+```bash
+brew install openclaw/tap/crabbox
+```
+
+---
+
+## 2. Get Your API Key
+
+Go to the [Upstash Console](https://console.upstash.com) and create a Box API key. Then export it in your terminal:
+
+```bash
+export UPSTASH_BOX_API_KEY=your_api_key_here
+```
+
+---
+
+## 3. Warm Up a Box
+
+Create a box with the `warmup` command. This provisions the box ahead of time so it's ready when you need it.
+
+```bash
+crabbox warmup --provider upstash-box --upstash-box-runtime node --upstash-box-size small
+```
+
+You can customize the box to match your project's needs:
+
+| Flag | Description | Values |
+|---|---|---|
+| `--upstash-box-runtime` | Runtime environment | `node`, `python`, `golang`, `ruby`, `rust` (or `-alpine` variants) |
+| `--upstash-box-size` | Box size | `small`, `medium`, `large` |
+| `--upstash-box-workdir` | Working directory inside the box | Any path (default: `/workspace/home/crabbox`) |
+| `--upstash-box-keep-alive` | Keep the box up and running at all times | `true` / `false` |
+
+---
+
+## 4. Run Your Tests
+
+Run your test command inside the box. Use `--env-from-profile` to load environment variables from a local `.env` file — they'll be injected into the box without being stored anywhere.
+
+```bash
+crabbox run --provider upstash-box --env-from-profile .env -- pnpm test
+```
+
+You can use any package manager or test runner:
+
+```bash
+# npm
+crabbox run --provider upstash-box --env-from-profile .env -- npm test
+
+# bun
+crabbox run --provider upstash-box --env-from-profile .env -- bun test
+```
+
+---
+
+For the full list of commands and options, see the [Upstash Box provider reference](https://crabbox.sh/providers/upstash-box.html).

docs.json

@@ -1654,7 +1654,7 @@
           },
           {
             "group": "Guides",
-            "pages": ["box/guides/remote-development", "box/guides/code-review-agent", "box/guides/openclaw-setup", "box/guides/hermes-setup"]
+            "pages": ["box/guides/remote-development", "box/guides/code-review-agent", "box/guides/openclaw-setup", "box/guides/hermes-setup", "box/guides/crabbox-setup"]
           }
         ]
       },

llms-full.txt

@@ -854,6 +854,72 @@ if (result.verdict === "changes_requested") {
 
 This gives you an automated gate similar to CodeRabbit or Greptile, running inside an isolated, durable Box.
 
+# Running Tests with Crabbox
+Source: https://upstash.com/docs/box/guides/crabbox-setup
+
+[Crabbox](https://crabbox.sh) is a CLI tool that runs commands inside a remote box from your local machine. This guide shows how to use it with Upstash Box to run your test suite in a clean cloud environment without touching your local setup.
+
+***
+
+## 1. Install Crabbox
+
+```bash
+brew install openclaw/tap/crabbox
+```
+
+***
+
+## 2. Get Your API Key
+
+Go to the [Upstash Console](https://console.upstash.com) and create a Box API key. Then export it in your terminal:
+
+```bash
+export UPSTASH_BOX_API_KEY=your_api_key_here
+```
+
+***
+
+## 3. Warm Up a Box
+
+Create a box with the `warmup` command. This provisions the box ahead of time so it's ready when you need it.
+
+```bash
+crabbox warmup --provider upstash-box --upstash-box-runtime node --upstash-box-size small
+```
+
+You can customize the box to match your project's needs:
+
+| Flag | Description | Values |
+|---|---|---|
+| `--upstash-box-runtime` | Runtime environment | `node`, `python`, `golang`, `ruby`, `rust` (or `-alpine` variants) |
+| `--upstash-box-size` | Box size | `small`, `medium`, `large` |
+| `--upstash-box-workdir` | Working directory inside the box | Any path (default: `/workspace/home/crabbox`) |
+| `--upstash-box-keep-alive` | Keep the box up and running at all times | `true` / `false` |
+
+***
+
+## 4. Run Your Tests
+
+Run your test command inside the box. Use `--env-from-profile` to load environment variables from a local `.env` file — they'll be injected into the box without being stored anywhere.
+
+```bash
+crabbox run --provider upstash-box --env-from-profile .env -- pnpm test
+```
+
+You can use any package manager or test runner:
+
+```bash
+# npm
+crabbox run --provider upstash-box --env-from-profile .env -- npm test
+
+# bun
+crabbox run --provider upstash-box --env-from-profile .env -- bun test
+```
+
+***
+
+For the full list of commands and options, see the [Upstash Box provider reference](https://crabbox.sh/providers/upstash-box.html).
+
 # Hermes Setup
 Source: https://upstash.com/docs/box/guides/hermes-setup
 

llms.txt

@@ -33,6 +33,7 @@
 - [Get Index Stats](https://upstash.com/docs/api-reference/vector/get-index-stats.md): Retrieves statistics and metrics for a specific vector index
 - [Get Vector Stats](https://upstash.com/docs/api-reference/vector/get-vector-stats.md): Get vector statistics for all the vector indices associated with the authenticated user
 - [Build a Code Review Agent](https://upstash.com/docs/box/guides/code-review-agent.md)
+- [Running Tests with Crabbox](https://upstash.com/docs/box/guides/crabbox-setup.md)
 - [Hermes Setup](https://upstash.com/docs/box/guides/hermes-setup.md)
 - [OpenClaw Setup](https://upstash.com/docs/box/guides/openclaw-setup.md)
 - [Remote Development](https://upstash.com/docs/box/guides/remote-development.md)