00PURE PION SOFTWARE REGISTRY

The native app shelf for humans and agents

A zero-bundle Metal desktop client, an agent-first JSON CLI, a SQLite WAL registry backend, and a sandboxed Wasm 1.0 mini-app runtime. Written in 100% Pure Pion with zero bundled assets.

8 apps Live same-origin catalog
703 KB Zero-bundle Metal client
100% Pure Pion Server / CLI / Desktop / Wasm VM
SQLite WAL Live persistent backend
Metal 2x Offscreen Capture
Shelf native Metal discover screen capture

Every frame above is a genuine 2x Metal offscreen render from the Pure Pion Shelf desktop app (zero mockups). The Discover capture automatically follows your Light or Dark theme.

01LIVE REGISTRY

Live Software Catalog

Hydrated directly from same-origin /v1/catalog and /v1/search. Open any app card to inspect screenshots, SHA-256 digests, and install commands.

API Online SQLite WAL Loading
Loading live registry...
02DUAL-TRACK DISTRIBUTION

Dual-Track Publishing & Claim Handoff

Combine developer self-publishing with curated upstream feeds so teams and agents can install essential native apps immediately without blocking ownership.

TRACK A / publisher

Developer Self-Publish

Register an account, mint an shf_ API token, and upload manifests, icons, screenshots, and Wasm payloads via CLI. Cross-owner writes are strictly blocked with HTTP 403.

POST /v1/auth/register POST /v1/apps + PUT assets / module.wasm Strict 403 owner isolation
TRACK B / curated

Curated Listings & Upstream Sync

Maintainers curate verified native apps from GitHub Releases and official release feeds, syncing Stable and Beta channel artifacts and SHA-256 digests automatically.

POST /v1/curate/apps POST /v1/refresh upstream sync listing_mode = curated
HANDOFF / claim

Atomic Ownership Transfer

Original authors claim curated entries with an atomic handoff that switches ownership and flips listing_mode to publisher, recorded in audit_log.

POST /v1/apps/:id/transfer curated -> publisher handoff Immutable audit_log trail
03AGENT-FIRST CLI

Built for Terminals and Autonomous Agents

Every command supports non-interactive --json output and environment configuration. Auth headers pass through curl -K - stdin so tokens never appear in argv.

Deterministic --json Output Catalog listings, search rankings, app metadata, publish results, and Wasm execution metrics serialize as clean machine-readable JSON.
SHELF_API_URL / SHELF_TOKEN Defaults to https://shelf.monoid.build and switches seamlessly to private registries via flags or environment variables.
Zero argv Secret Leakage Bearer tokens are piped privately into the HTTP transport via stdin config rather than process arguments visible to ps.
# Inspect the live catalog and install native apps
shelf list --json
shelf search browser --json
shelf info stillfail
shelf install stillfail
04ARCHITECTURE & SECURITY

Architectural & Security Guards

Every security invariant from upload validation to local execution is enforced natively inside Pure Pion and verified in CI.

01 / THIN CLIENT

703 KB Zero-Bundle Thin Client

The stripped Metal desktop binary is 703 KB with zero bundled images, catalogs, or Wasm payloads. Assets stream on demand into a SHA-256 local cache.

02 / WASM 1.0 GATE

Upload Pre-Instantiation & Gas Metering

Every uploaded .wasm module is trial-instantiated inside the Pure Pion sandbox before acceptance, with a 64-page (4 MiB) cap, zero host imports, and gas traps.

03 / CREDENTIAL HYGIENE

10,000-Round Salted SHA-256 Auth

Passwords use 10,000-round salted SHA-256 with constant-time verification. Bearer shf_ tokens are stored as SHA-256 digests only, with zero plaintext secrets in SQLite.

04 / PURE PION STACK

100% Pure Pion End-to-End

Compiler, SQLite WAL registry, HTTP/1.1 server, Wasm 1.0 interpreter, Metal UI, and CLI share one Pure Pion codebase with zero bloated runtimes.

LIVE ENDPOINTPRODUCTION REGISTRY

Connect to the Live Shelf Registry

Query the production catalog over HTTPS or point the CLI and native Metal client at the live endpoint.

https://shelf.monoid.build