instabox 0.8.38 → 0.8.40

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
+4ac8957ca170a605025f3506e6ddc2edce2df67230f9d7b9d06b315ab837dc22  instabox-darwin-amd64
+cdff54464dd57a5b21b64bef08a791fb16bcab8ac0076462aa87c9399bd540af  instabox-darwin-arm64
+da930996e671d53ac63dbf3f7f5c8303083deb2eea5c50f2a46a9a42b3ca3383  instabox-linux-amd64
+e10bb94c0a800824560856eebf0abed30885f00e9cfa6518804cba7c52ec2bc8  instabox-linux-arm64
+cf22c363a9cce8928d9bcc42de52472aa8dca237ad3b67cdefc58be894333d38  instabox-windows-amd64.exe
+79f74cd8f1947f17e3ef03a23c0ae66a2bffd6a38480805d936f26002922b10c  instabox-windows-arm64.exe

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instabox",
-  "version": "0.8.38",
+  "version": "0.8.40",
   "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