the universal sandbox runtime for agents and humans.
pocketenv.io
sandbox
openclaw
agent
claude-code
vercel-sandbox
deno-sandbox
cloudflare-sandbox
atproto
sprites
daytona
Add sandbox backup commands and docs
Reduce default backup TTL from 7d to 3d
+64
-1
+15
CHANGELOG.md
+15
CHANGELOG.md
···
2
2
3
3
All notable changes to this project will be documented in this file.
4
4
5
+
## [0.6.9] - 2026-04-07
6
+
7
+
### Added
8
+
9
+
- **Sandbox backup commands**: New `pocketenv backup` subcommand group for managing sandbox backups.
10
+
- `pocketenv backup create <sandbox> <directory>` — create a backup of a directory inside a sandbox, with optional `--description` and `--ttl` (e.g. `10m`, `2h`, `7d`; default `3d`).
11
+
- `pocketenv backup restore <backup_id>` — restore a sandbox from a previously created backup.
12
+
- `pocketenv backup list <sandbox>` (alias: `ls`) — list all backups for a sandbox, showing backup ID, directory, creation time, and expiry.
13
+
14
+
### Changed
15
+
16
+
- **Default backup TTL reduced to `3d`**: The default time-to-live for new backups is now `3d` (was `7d`).
17
+
18
+
---
19
+
5
20
## [0.6.8] - 2026-04-06
6
21
7
22
### Changed
+48
apps/cli/README.md
+48
apps/cli/README.md
···
305
305
306
306
---
307
307
308
+
### 💾 Backups
309
+
310
+
Create and restore point-in-time backups of sandbox directories.
311
+
312
+
#### `pocketenv backup create <sandbox> <directory>`
313
+
314
+
Create a backup of a directory inside a sandbox.
315
+
316
+
| Option | Description |
317
+
|-------------------------------|----------------------------------------------------|
318
+
| `--description, -d <text>` | Optional description for the backup |
319
+
| `--ttl, -t <duration>` | Time-to-live (e.g. `10m`, `2h`, `7d`; default `3d`) |
320
+
321
+
```sh
322
+
pocketenv backup create my-sandbox /workspace
323
+
pocketenv backup create my-sandbox /workspace --description "pre-deploy" --ttl 7d
324
+
```
325
+
326
+
---
327
+
328
+
#### `pocketenv backup list <sandbox>`
329
+
330
+
List all backups for a sandbox. Aliases: `ls`
331
+
332
+
```sh
333
+
pocketenv backup list my-sandbox
334
+
pocketenv backup ls my-sandbox
335
+
```
336
+
337
+
Output example:
338
+
339
+
```
340
+
BACKUP ID DIRECTORY CREATED AT EXPIRES AT
341
+
bkp_01jqwerty123456789 /app 2 hours ago in 3 days
342
+
```
343
+
344
+
---
345
+
346
+
#### `pocketenv backup restore <backup_id>`
347
+
348
+
Restore a sandbox from a backup.
349
+
350
+
```sh
351
+
pocketenv backup restore bkp_01jqwerty123456789
352
+
```
353
+
354
+
---
355
+
308
356
## ⚙️ Configuration
309
357
310
358
The CLI can be configured via the following environment variables: