# codesandbox-sdk

> Programmatically start (AI) sandboxes on top of CodeSandbox

- **URL**: https://www.freshcrate.ai/projects/codesandbox-sdk
- **Author**: codesandbox
- **Category**: Uncategorized
- **Latest version**: `v2.4.2` (2025-12-04)
- **License**: Unknown
- **Source**: https://github.com/codesandbox/codesandbox-sdk
- **Homepage**: https://codesandbox.io/docs/sdk
- **Language**: TypeScript
- **GitHub**: 106 stars, 35 forks
- **Registry**: github
- **Tags**: `typescript`

## Description

Programmatically start (AI) sandboxes on top of CodeSandbox

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v2.4.2` | 2025-12-04 | Low | ## [2.4.2](https://github.com/codesandbox/codesandbox-sdk/compare/v2.4.1...v2.4.2) (2025-12-04)   ### Bug Fixes  * send params to restart correctly ([#232](https://github.com/codesandbox/codesandbox-sdk/issues/232)) ([c9775c4](https://github.com/codesandbox/codesandbox-sdk/commit/c9775c43eecdda38b3c7ea309e03610edeb73b0f)) |
| `v2.4.1` | 2025-10-23 | Low | ## [2.4.1](https://github.com/codesandbox/codesandbox-sdk/compare/v2.4.0...v2.4.1) (2025-10-23)   ### Bug Fixes  * reconnect issue ([#216](https://github.com/codesandbox/codesandbox-sdk/issues/216)) ([2dfa670](https://github.com/codesandbox/codesandbox-sdk/commit/2dfa670a62d320ffe9b50831e212ede5ae90732d)) |
| `v2.4.0` | 2025-10-16 | Low | ## [2.4.0](https://github.com/codesandbox/codesandbox-sdk/compare/v2.3.0...v2.4.0) (2025-10-16)  ### Infra updates (Agent version `0.369.6`)  - Default to `rsync` persistence for both change of remote and nested git - Increase `ulimit` for global user - Do not use `.gitignore` during `rsync`  ### Features  * batch writes in template build ([#205](https://github.com/codesandbox/codesandbox-sdk/issues/205)) ([9b2f3f6](https://github.com/codesandbox/codesandbox-sdk/commit/9b2f3f66c4a0b3fa |
| `v2.3.0` | 2025-09-29 | Low | ## [2.3.0](https://github.com/codesandbox/codesandbox-sdk/compare/v2.2.1...v2.3.0) (2025-09-29)  ### **History of Hibernation and Persistence**  In the original CodeSandbox design, we optimized sandbox lifecycles to feel like cloud-based laptops. When a user stepped away from a project, the sandbox would automatically hibernate after a short period of inactivity. On return, the sandbox would restore almost instantly to its previous state — including memory and persistence.  At the time, mo |
| `v2.2.1` | 2025-09-16 | Low | ## [2.2.1](https://github.com/codesandbox/codesandbox-sdk/compare/v2.2.0...v2.2.1) (2025-09-16)   ### Bug Fixes  * Throw error when invalid port is used ([#188](https://github.com/codesandbox/codesandbox-sdk/issues/188)) ([d0bdf31](https://github.com/codesandbox/codesandbox-sdk/commit/d0bdf3128787cdea22ea7e18c5af63594c303402)) |
| `v2.2.0` | 2025-09-02 | Low | ## [2.2.0](https://github.com/codesandbox/codesandbox-sdk/compare/v2.1.0...v2.2.0) (2025-09-02)   ### Features  * Add traceparent for all requests to API ([#180](https://github.com/codesandbox/codesandbox-sdk/issues/180)) ([b6f4846](https://github.com/codesandbox/codesandbox-sdk/commit/b6f484665de0bf0533127e098ff0ef1aa641a84b)) * batch writes ([#175](https://github.com/codesandbox/codesandbox-sdk/issues/175)) ([493c5d5](https://github.com/codesandbox/codesandbox-sdk/commit/493c5d52d1eaa527d099b0 |
| `v2.1.0` | 2025-08-22 | Low | ## [2.1.0](https://github.com/codesandbox/codesandbox-sdk/compare/v2.0.7...v2.1.0) (2025-08-22)   ### Features  * add fetching single sandbox ([#142](https://github.com/codesandbox/codesandbox-sdk/issues/142)) ([2f58d43](https://github.com/codesandbox/codesandbox-sdk/commit/2f58d43ee44c98eeb7d0e917c8b423a80d202585)) * add listRunning method to sandboxes namespace ([#145](https://github.com/codesandbox/codesandbox-sdk/issues/145)) ([6050dbd](https://github.com/codesandbox/codesandbox-sdk/co |
| `v2.0.7` | 2025-08-06 | Low | ## [2.0.7](https://github.com/codesandbox/codesandbox-sdk/compare/v2.0.6...v2.0.7) (2025-08-06)   ### Bug Fixes  * also retry resume ([#143](https://github.com/codesandbox/codesandbox-sdk/issues/143)) ([8b69036](https://github.com/codesandbox/codesandbox-sdk/commit/8b69036d0b586917db05f9c51046ae8b26660835)) |
| `v2.0.6` | 2025-08-06 | Low | ## [2.0.6](https://github.com/codesandbox/codesandbox-sdk/compare/v2.0.5...v2.0.6) (2025-08-06)   ### Bug Fixes  * Add retries to all idempotent endpoints and added parallel file writing ([#140](https://github.com/codesandbox/codesandbox-sdk/issues/140)) ([db8aded](https://github.com/codesandbox/codesandbox-sdk/commit/db8aded97e1844cc31f70b08b6a294b458069656)) * Fix broken authorization in preview hosts ([20a4e53](https://github.com/codesandbox/codesandbox-sdk/commit/20a4e538e3b47300778383 |
| `v2.0.5` | 2025-07-29 | Low | ## [2.0.5](https://github.com/codesandbox/codesandbox-sdk/compare/v2.0.4...v2.0.5) (2025-07-29)   ### Bug Fixes  * timeout errors on keepActiveWhileConnected ([a519bcf](https://github.com/codesandbox/codesandbox-sdk/commit/a519bcfe86abe2f978718169490a54d9977a9d88)) |

## Dependency audit

- **Score**: 96/100
- **Total deps**: 46
- **Resolved**: 46
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 2
- **Scanned**: 2026-06-01

## Citation

- HTML: https://www.freshcrate.ai/projects/codesandbox-sdk
- Markdown: https://www.freshcrate.ai/projects/codesandbox-sdk.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/codesandbox-sdk/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._