tools

Prepare the in-browser editor before opening a gallery, or check what is on disk.

pixelkiln tools status
pixelkiln tools install editor
PIXELKILN_TOOLS_DIR=/srv/pixelkiln-tools pixelkiln tools install editor

The editor is a web build of Pixelorama with a small PixelKiln bridge extension, about 46 MB, and is not part of the npm package. Each PixelKiln release pins one build, meaning its GitHub release tag (editor-pixelorama-<upstream tag>-pk.<n>) and the SHA-256 and size of every file. install fetches only the files that are missing or wrong from that release, verifies each against the pinned hash before it lands, and leaves nothing partial behind: a file that fails verification is discarded and the command fails naming it. status reports the pinned version, the release, and whether every file is present and verified (--json for the machine-readable form). Running install on a complete build fetches nothing.

The files live outside the project, in a per-release directory under the user's cache (~/Library/Caches/pixelkiln/tools on macOS, $XDG_CACHE_HOME or ~/.cache/pixelkiln/tools on Linux, %LOCALAPPDATA%\pixelkiln\tools on Windows), so one copy serves every project and an upgrade never overwrites the build an older PixelKiln still expects. PIXELKILN_TOOLS_DIR moves that root; PIXELKILN_EDITOR_URL points the download at a mirror or an internal server that hosts the same files (they are still verified against the pinned hashes, so a mirror cannot substitute a different build). Once installed the editor runs entirely offline; the gallery serves it from the local directory with no outbound requests.