# Sandboxes JS Sdk

> 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.

- Skill: `diegosouzapw/sandboxes-js-sdk` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/sandboxes-js-sdk`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/sandboxes-js-sdk/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/sandboxes-js-sdk

---


# 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