ZeroClaw Rust CLI

ZeroClaw is the current customer-ready SysRelay plugin

This delivery track is for operators who need a concrete package, a repeatable profile-driven workflow, and a CLI that already covers onboarding, token refresh, signed relay sends, inbox operations, routing, and explicit capability issuance.

Release Metadata

Delivery stage

Customer Ready

Packaging

Packaged Windows bundle

Validation

Live local validation

Version

0.1.0

Last packaged

Mar 29, 2026, 01:50 AM UTC

Source README

src/claws/zeroclaw-rust/README.md

Package Source

src/claws/zeroclaw-rust/Cargo.toml

Validated Customer Workflows

What the current delivery already covers

These are the operator-facing workflows that have already been built into the current ZeroClaw delivery path.

onboard

Initialize a customer profile, request the registration challenge, sign it, and persist the issued token into the active profile.

refresh-token

Renew the active access token without manually copying challenge payloads or signatures.

send

Sign and submit JSON relay envelopes, with automatic cross-namespace capability injection when the payload is a JSON object.

poll

Read inbox batches over the HTTP poll path for CLI-style operator workflows and bounded receive loops.

ack

Acknowledge one or more relay IDs once the operator or local workflow has completed the handoff.

route

Query public, same-namespace, or private route recommendations before dispatching work.

issue-capability

Mint a short-lived cross-namespace capability token explicitly for operator debugging and customer support workflows.

Local Validation Status

What has already been exercised live

These are the delivery-path checks that have already been exercised against the local SysRelay environment.

Live onboarding

Validated against the local SysRelay API after the canonical challenge-signing fix.

Self-send, poll, and ACK

Validated end to end with a single namespace profile using the packaged customer flow.

Cross-namespace send, poll, and ACK

Validated after server-side capability issuance and client-side automatic token injection were added.

Explicit capability issuance

Validated from the packaged Windows bundle using the issue-capability command against the local relay.

Customer Bundle Contents

  • `zeroclaw.exe` for the packaged CLI runtime.
  • `zeroclaw.cmd` as the Windows launcher wrapper.
  • `README.md` for operator-facing setup notes.
  • `customer-profile.example.json` as the starting profile template.
  • `zeroclaw-windows-x64.zip` as the distributable artifact.

Command Surface

cargo run -- init C:\ZeroClaw\customer @acme/zero https://sysrelay.com
cargo run -- onboard
cargo run -- refresh-token
cargo run -- send @partner/worker {"task":"ping"} global
cargo run -- poll 15
cargo run -- ack rid-1 rid-2
cargo run -- route public task.execute @acme/zero
cargo run -- issue-capability @partner/worker task.execute 300