# kosa8 cloud

Run sandboxes on kosa8 Cloud (api.kosa8.com)

kosa8 Cloud runs the same sealed sandboxes on kosa8's hosts, or on your own,
billed by the second. Sign in once (kosa8 login, or an API key), then make, run in, sleep
and remove cloud sandboxes from here; the dashboard at https://app.kosa8.com
shows the same ones.

  kosa8 login                       # sign in in your browser
  kosa8 cloud login --key k8c_live_…  # or with an API key (CI)
  kosa8 cloud sandbox create        # prints its ID and a dashboard link
  kosa8 cloud sandbox exec ID -- uname -a
  kosa8 cloud usage                 # this month's bill so far
  kosa8 cloud mcp                   # connect Claude Code, Cursor or Codex

The key is kept in ~/.kosa8/cloud.json, readable only by you, and shared with
the kosa8 desktop app. KOSA8_API_KEY and KOSA8_API_URL, which the SDKs read,
take precedence when set.

## Flags

| Flag | Type | What it does | Default |
|---|---|---|---|
| `--api` | string | kosa8 Cloud API address (default: KOSA8_API_URL, then the signed-in address, then https://api.kosa8.com) |  |

## Subcommands

- [`kosa8 cloud login`](https://docs.kosa8.com/reference/cloud-login.md): Sign in to kosa8 Cloud: in your browser, or with an API key
- [`kosa8 cloud logout`](https://docs.kosa8.com/reference/cloud-logout.md): Forget the kosa8 Cloud key on this machine
- [`kosa8 cloud mcp`](https://docs.kosa8.com/reference/cloud-mcp.md): Connect Claude Code, Cursor or Codex to kosa8 Cloud's MCP server
- [`kosa8 cloud open`](https://docs.kosa8.com/reference/cloud-open.md): Open the kosa8 Cloud dashboard, at a sandbox if given
- [`kosa8 cloud refer`](https://docs.kosa8.com/reference/cloud-refer.md): Show your Refer and earn link, earnings and invitations
- [`kosa8 cloud sandbox`](https://docs.kosa8.com/reference/cloud-sandbox.md): Make, list, run in, sleep, wake and remove cloud sandboxes
- [`kosa8 cloud usage`](https://docs.kosa8.com/reference/cloud-usage.md): Show this month's kosa8 Cloud usage and estimated bill
- [`kosa8 cloud whoami`](https://docs.kosa8.com/reference/cloud-whoami.md): Show the kosa8 Cloud organization and key in use

---
Source: https://docs.kosa8.com/reference/cloud/