prx-cli 0.1.0

.prx format toolkit and prxhub CLI

prx

Toolkit and hub CLI for the .prx research bundle format.

prx reads, validates, diffs, merges, signs, and publishes .prx archives — the open, portable format for multi-provider AI research produced by parallect. It also ships a prxhub client for searching, cloning, forking, and collaborating on published bundles.

$ prx read results.prx
$ prx publish results.prx --collection ai-safety
$ prx open                   # Terminal UI browser

Install

pip install prx-cli

The CLI is installed as prx (the PyPI distribution is prx-cli because prx was already taken).

For the interactive TUI browser:

pip install 'prx-cli[tui]'

Requires Python 3.10+.

What you can do

• Read + validate any .prx bundle — L0/L1/L2 structural checks
• Verify attestations — Ed25519 JWS signatures and per-file attestations
• Diff and merge bundles — compute consensus + disagreement between research runs
• Publish to prxhub — share, tag, collection-assign, fork, star
• Manage signing keys — generate, list, register with the hub, revoke
• Browse visually — a terminal UI for exploring bundle contents (with [tui] extra)

Quick start

Working with local bundles

# Inspect the contents
prx read results.prx

# Structural validation (L0/L1/L2)
prx validate results.prx

# Verify Ed25519 attestations
prx verify results.prx

# Diff two bundles — shows added/removed claims and provider drift
prx diff a.prx b.prx

# Merge bundles — combines providers, claims, and sources
prx merge a.prx b.prx -o combined.prx

# Export for sharing
prx export results.prx --format markdown

Publishing to prxhub

# One-time setup — interactive config for API key and signing identity
prx config

# Generate a signing keypair (stored in ~/.config/prx/)
prx keys generate

# Publish a bundle
prx publish results.prx --visibility public --tags "consensus,distributed-systems"

# Publish directly into a collection (created if missing)
prx publish results.prx --collection ai-safety

# Search the hub
prx search "quantum computing"

# Clone someone else's bundle
prx clone alice/quantum-consensus

Repositories, branches, merge requests

prxhub supports Git-style collaboration on research. See docs/PRXHUB.md for the full workflow.

prx repo create my-research --description "Ongoing literature review"
prx branch create alice/my-research experiment
prx push results.prx --repo my-research --branch experiment
prx mr create alice/my-research --source experiment --target main

Terminal UI

prx open

Browse installed bundles, read synthesis + per-provider reports, and search hub content without leaving the terminal. See docs/TUI-GUIDE.md.

Commands

Bundle tools (offline)

Command	Purpose
prx read <bundle>	Display bundle contents (query, providers, synthesis)
prx validate <bundle>	Structural validation (L0/L1/L2)
prx verify <bundle>	Verify cryptographic attestations
prx diff <a> <b>	Compare two bundles
prx merge <a> <b> -o <out>	Merge providers, claims, sources
prx export <bundle>	Export to markdown / JSON
prx list <dir>	List bundles in a directory
prx open	Terminal UI browser (requires [tui])

Hub commands

Command	Purpose
prx config	Interactive configuration
prx publish <bundle>	Upload to prxhub
prx search <query>	Search published bundles
prx clone <owner/repo>	Download a published bundle
prx fork <owner/repo>	Fork for follow-on research
prx star <owner/repo>	Star a bundle
prx repo <subcmd>	Repository management
prx branch <subcmd>	Branch management
prx push <bundle>	Push to a repo branch
prx mr <subcmd>	Merge request management

Key management

Command	Purpose
prx keys generate	Generate an Ed25519 signing keypair
prx keys list	List local keys
prx keys register	Register a public key with prxhub
prx keys revoke	Revoke a registered key

Run prx <command> --help for full flags.

Configuration

prx config writes to ~/.config/prx/config.toml:

• prxhub API key — for publishing and hub operations (get one at prxhub.com)
• Default visibility — public, unlisted, or private
• Signing identity — name or email embedded in bundle attestations

Documentation

• Format Guide — .prx bundle structure
• TUI Guide — terminal UI reference
• prxhub Guide — publishing, collections, repos, merge requests

Development

git clone https://github.com/parallect/prx.git
cd prx
uv sync --group dev
uv run pytest tests/ -x -q
uv run ruff check src/ tests/

Contributing

Contributions welcome — see CONTRIBUTING.md. For security reports, email [e-mail].

License

MIT — see LICENSE.

---

Built by SecureCoders. A hosted managed version is available at parallect.ai — same .prx output, with a multi-provider research API, billing, and a web dashboard.