QS-STORE CLI

Install locally. Stay in control.

The CLI is a native Rust tool for validating, installing, enabling, disabling, and rolling back local Quickshell widgets.

Download a release

Download the current pre-built release for Linux x86_64:

Download qs-store CLI v0.1.0 (.zip)

SHA-256:

0de14db0298d7a2a45d39d125eedd0b293ccd9e04511e0b80539f84c61bff8d6

This release targets Linux x86_64 with the system GNU C library. It was built and verified on Arch Linux x86_64. Other distributions may work when their runtime provides a compatible glibc; ARM and other architectures should use the source build below.

Build from source

Build the CLI from a QS Store source checkout with Rust and Cargo installed:

cargo install --path client/cli

# Or build a release binary
cargo build --release --manifest-path client/cli/Cargo.toml
./target/release/qs-store --help

Only the Linux x86_64 ZIP is currently published. A signed binary download channel for more platforms is planned.

Validate and install a widget

# Validate a widget directory or ZIP
qs-store validate ./my-widget

# Install an artifact locally
qs-store install ./my-widget.zip

# Review installed versions and enable one
qs-store list
qs-store enable org.qsstore.clock
qs-store info org.qsstore.clock

Manage safely

Recover

Use rollback to return to the previous installed version, or disable a widget without removing its files.

Inspect

Use doctor to check the local environment. Artifact hashes are recorded so a downloaded file can be verified before installation.

qs-store disable org.qsstore.clock
qs-store rollback org.qsstore.clock
qs-store remove org.qsstore.clock
qs-store doctor

Read before installing

Manifest permissions describe declared capabilities; they are not a sandbox. Review a widget's source, author, license, compatibility, and SHA-256 before installing third-party QML.

Read the full service statement →