Native control plane, package manager, binary installer, and Ratatui TUI dashboard for Santity.

cargo install santity

Run santity up to trigger the interactive setup wizard. It will prompt for your Discord Bot Token and automatically install santity-core if it's missing:

santity up

You can install official compiled plugins directly from GitHub Releases:

santity plugin add https://github.com/segv-oss/santity-plugins/releases/latest/download/ping_pong.component.wasm

Or scaffold a custom plugin:

santity new my_bot_plugin
cd my_bot_plugin
santity build --release
santity plugin add target/wasm32-unknown-unknown/release/my_bot_plugin.component.wasm

Stream real-time IPC logs, active WASM actors, slash command routers, memory stats, and permit pool gauges:

santity ui

santity (packaged as santity, source repo santity-cli) is the local-first operator tool and package manager for the Santity WebAssembly runtime. It communicates with santity-core over Unix Domain Socket IPC (/tmp/santity.sock).

Runs the interactive setup wizard (if ~/.config/santity/config.toml is unconfigured), auto-installs santity-core if missing, and boots santity-core via systemd user service or background daemon.

Manages the santity-core runtime engine binary (auto-installing via cargo install santity-core or displaying status/location).

Cleanly terminates the running santity-core daemon process.

Downloads a .component.wasm plugin binary (from a local file path or GitHub Release URL), prompts for capability domain whitelisting (allowed_domains), updates config.toml, and performs a POSIX atomic move into ~/.config/santity/plugins/ to trigger zero-downtime hot-reloading.

Lists all installed plugins and their granted capability domains.

Launches an interactive, split-pane Ratatui TUI dashboard streaming real-time IPC logs, active WASM plugin actors, memory stats, and permit pool gauges.

Scaffolds a new PDK guest WebAssembly plugin project from template.

Compiles guest Rust code to WASM (wasm32-unknown-unknown) and automatically translates it into a Component Model binary using wasm-tools.

Dual-licensed under MIT or Apache 2.0.