Repository navigation
kumoba v0.2.0
Added
kumobaCLI, built for people and for agents. It has no commands of its own: it reads the daemon's catalog and builds every command, argument check and help page from it. Ships natively with the daemon (install.sh, release tarballs,cargo install kumobad) and through npm (npx kumoba).execandrunexit with the guest command's status.GET /v1/commands: every route with a JSON Schema for its input, so clients and agents can discover the API.POST /v1/runandKumoba.run(): one command in a fresh sandbox that is deleted when it ends.POST /v1/sandboxes/{id}/desktop: starts the desktop and returns a link to a live noVNC view.- Browser previews on a separate loopback listener (
KUMOBAD_PREVIEW_LISTEN, default127.0.0.1:7789), so exposed web apps and the desktop render in a browser while staying off the API's origin. Preview and desktop responses carry a fullurl.
Changed
- With no configuration
kumobadalso listens on127.0.0.1:7788, and on127.0.0.1:7789for previews; either is skipped if its port is taken. - A bare program name in
execorrun(python3) is looked up on the guest'sPATHinstead of being rejected. - The SDK reports an unreachable daemon with the error code
unreachable. - Dependencies:
sha20.11 withhmac0.13,base640.23,libloading0.9, TypeScript 7, vitest 5, and newer GitHub Actions.
Fixed
- Previews no longer wait on a guest server that keeps its connection open: responses are read to their declared length, and plain requests reach the guest as one-shot HTTP/1.0. Page loads through a preview dropped from about 5 s per file to milliseconds.
- Redirects from a preview stay inside that preview: the guest's
locationis resolved with a URL parser and anything leaving the guest origin is dropped. - The desktop's accessibility tree retries while the AT-SPI bus is still starting, instead of failing right after
desktop.start().
Install
curl -fsSL https://raw.githubusercontent.com/Parassharmaa/kumoba/main/scripts/install.sh | KUMOBA_VERSION=0.2.0 bash
npm install kumoba@0.2.0The installer puts the kumobad daemon, the kumoba CLI, kumoba-worker and the default image into ~/.kumoba; npx kumoba gives the same CLI through npm; on macOS install libkrun first with brew tap slp/krun && brew install slp/krun/libkrun slp/krun/libkrunfw zstd. cargo install kumobad@0.2.0 builds the daemon and worker from crates.io instead, and the Rust library is cargo add kumoba@0.2.0.
The files below are the host tarballs (Linux ones bundle the patched libkrun and libkrunfw; the macOS worker is signed for Hypervisor.framework), the default and test guest images for each architecture, and SHA256SUMS. Guest images from an earlier release must be replaced when the protocol version changes.
Full Changelog: v0.1.0...v0.2.0