Guardship

Ruby wrapper and release packaging for Mothership, the process supervisor with HTTP exposure.

Installation

RubyGems should resolve the matching platform gem automatically on supported targets:

gem install guardship

The generic guardship gem is a stub. Platform-specific releases carry the bundled native mothership binary.

What Is Included

• Stub gem:
  • Ruby launcher only
  • no bundled native binary
• Platform gems:
  • mothership native binary under libexec/
  • tokio-postgres support for flagship PostgreSQL coordination
  • wasmtime support for WASM request/response modules

Usage

mothership --config mothership.toml

If you install the stub gem directly on a platform without a matching packaged binary, the launcher will tell you that no bundled binary is present.

Supported Platforms

• Linux: x86_64-linux, aarch64-linux
• macOS: x86_64-darwin, arm64-darwin

All packaged binaries are precompiled. No local Rust toolchain is required to run the gem.

Release Workflow

cd mothership/gem
bundle exec rake gem:build
bundle exec rake gem:build_current_platform
bundle exec rake gem:build_platforms
bundle exec rake gem:push
# or
bundle exec rake gem:push_all

Documentation

• Main Repository
• Configuration Guide
• API Documentation

License

MIT