instabox 0.8.38 → 0.8.39

package/cli/SHA256SUMS

@@ -1,6 +1,6 @@
-d2092ec10dc8d47b0494e3b842e1f7ba376b0a28976460a44dee8c4400216b9e  instabox-darwin-amd64
-14a885cea6026932094c3b187e00dd32655972c2921a2bb318571a0f7e325a9e  instabox-darwin-arm64
-51aea6736c3eb5b80280793308eb9934938fedc51588552e2263ef632aeaeb99  instabox-linux-amd64
-1bf7ce48b1ba50daf8584707d99fa0316d5036c96df8ace50747c7ab7d70eda2  instabox-linux-arm64
-9c69b4ae32feb00b237a7170e89a9c633f11ed2ec8e3ca9ed4acfe75cf6e0a7e  instabox-windows-amd64.exe
-e63bd41974646998f02bcf075152774c4d04258c81ee869498f76f4c4e513a45  instabox-windows-arm64.exe
+71fa6e7b1df786a9519de5f77e5cdf44742da78cfe48c3a9a88f7df8c1c20ca8  instabox-darwin-amd64
+65ad6d18ecea7b8439e8e2e355501d4e08074049facfcc7a8101f4340ba063ff  instabox-darwin-arm64
+0ef01d9fafed68b88bb304522363656f3cd85dce93c27532f152cb8c58570f52  instabox-linux-amd64
+8f216f4c162e05afce5c39f0010ada3e4a1eedf2a84fa98df7c2be5a7caa4122  instabox-linux-arm64
+309aa5d07c5edd0737660de90e4f798be946b75dfe2ea698e2f8932bff9956cd  instabox-windows-amd64.exe
+3448fad2908f31f6181ebfd58d7e90c4bbf027bb9a572e90343ac3354cd295d5  instabox-windows-arm64.exe

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instabox",
-  "version": "0.8.38",
+  "version": "0.8.39",
   "description": "A cloud box for your coding agent, the instabox CLI and its agent skills in one command: npx instabox@latest",
   "type": "module",
   "bin": {

package/skills/instabox-snapshots/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: instabox-snapshots
-description: Use when the user wants to save an instabox box's state and load it later — "save a snapshot", "checkpoint this box", "restore/load from a snapshot", "start a new box from my setup", "clone this box". Covers instabox snapshot save/ls/files/rm, create --snapshot and fork.
+description: Use when the user wants to save an instabox box's state and load it later — "save a snapshot", "checkpoint this box", "restore/load from a snapshot", "start a new box from my setup", "clone this box", "a box from my Docker image". Covers instabox snapshot save/import/ls/files/rm, create --snapshot and fork.
 metadata:
   installed-by: instabox
 ---
@@ -65,6 +65,16 @@ instabox create --name work2 --snapshot work-copy --no-vault --secrets none
 
 To give the copy API credentials, name them with `--secrets NAME,NAME`. Placeholders copied from the source box do not work for the new one. New selections do not erase credentials that apps or people already wrote into files on the copied disks; review those before sharing the snapshot or the box.
 
+## A box from a Docker/OCI image
+
+```sh
+instabox snapshot import python:3.12 --name py312       # a few minutes: pulls, lays the image over a box, reboots it to check, saves
+instabox create --name dev --snapshot py312
+instabox exec dev -- python3 --version                  # the image's python
+```
+
+The box is a normal instabox box (systemd, sshd, sudo, the user, `/data`) with the image's files, `ENV` and users on top; the image's `ENTRYPOINT`/`CMD` runs as `instabox-image.service` (`--no-entrypoint` to skip; `journalctl -u instabox-image.service` for its output). Images must be `linux/amd64`. Private registries: `--registry-username U` with `INSTABOX_REGISTRY_PASSWORD` set or `--registry-password-stdin`. A locally built image must be pushed to a registry first (`ghcr.io`, or `ttl.sh` for a one-off). `--json` gives `{snapshot, image, digest, os, service, verified, ...}`; `--keep-builder` keeps the throwaway box for a look when something is off. Details and limits: `instabox help snapshot import`.
+
 ## Clean up
 
 ```sh