# sandboxes-js-sdk

Lets Node.js or TypeScript code create, start, stop and control Koyeb sandboxes through the official JavaScript SDK.

Skill by Koyeb. Category: Shipping and ops.

## Install

Project (for this project only):

```sh
npx skills add koyeb/koyeb-skills --skill sandboxes-js-sdk
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add koyeb/koyeb-skills --skill sandboxes-js-sdk -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Pass

Installs: 4. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/koyeb/koyeb-skills/sandboxes-js-sdk)

## Source

[Open the source](https://github.com/koyeb/koyeb-skills/tree/HEAD/plugins/koyeb/skills/sandboxes-js-sdk). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: sandboxes-js-sdk
description: Use the Koyeb Sandbox JS SDK (@koyeb/sandbox-sdk) to create and manage sandboxes programmatically from Node.js. Use when the user wants JavaScript/TypeScript sandbox automation.
license: MIT
compatibility: Requires Node.js, npm/pnpm, and network access.
metadata:
  author: koyeb
  version: "0.0.2"
---

# Koyeb Sandboxes (JS SDK)

## When to use

Use this skill when the user asks to manage Koyeb sandboxes from JavaScript or TypeScript using the official SDK.

## Prerequisites

- Node.js environment
- Package installed: `@koyeb/sandbox-sdk`
- API token available as `KOYEB_API_TOKEN`

## Workflow

1. Install the SDK package.
2. Configure authentication using `KOYEB_API_TOKEN`.
3. Create, start, or stop sandboxes as needed.
4. Execute commands or retrieve logs/status through the SDK.
5. Clean up sandboxes when finished.

## Examples

- Install the SDK: `npm install @koyeb/sandbox-sdk`
- Use token auth: set `KOYEB_API_TOKEN` in your environment

## References

For detailed flags and SDK usage, see references/koyeb-sandbox-js-sdk.md.

- references/koyeb-sdk-auth.md
- references/koyeb-sandbox-js-sdk.md
````

- Previous: [organizations](https://syn4pse.dev/terminal/koyeb-organizations.md)
- Next: [sandboxes-python-sdk](https://syn4pse.dev/terminal/koyeb-sandboxes-python-sdk.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
