instabox 0.8.37 → 0.8.39

package/cli/SHA256SUMS

@@ -1,6 +1,6 @@
-768a93646e4ad31ba35c58e509f44dd9e2bad8ebedbe902525e75405be42fbc2  instabox-darwin-amd64
-0b9237bff7fbb5dccfe9d6a178ec0c7fea47b326b8cf5570f9fc4658f108e02a  instabox-darwin-arm64
-3dc67dd2eaba6542496d7faefe5bc5257181e852bcc11e9a8efe35a4723a3ee0  instabox-linux-amd64
-9b7624800213ae62e0b06c5cc55caefad374292617573a2618a25d95ad0e836c  instabox-linux-arm64
-40f7c57066bcc262c74ed6962004d72e5a9f3868326ae78aab55f131aea3230b  instabox-windows-amd64.exe
-a50e741f6b30dc910ccfb47bebb4465eb49bafad9b349726c22de591ad9f2e14  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.37",
+  "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