PrimusFabrum
Repositories
11
 Projects Packages
1

@primsfabrum/primex (0.1.2-canary.c8e3795)

Published 2026-05-13 09:42:53 +02:00 by primus

Installation

@primsfabrum:registry=
npm install @primsfabrum/primex@0.1.2-canary.c8e3795
"@primsfabrum/primex": "0.1.2-canary.c8e3795"

About this package

PrimeX

Zero-config server suites. One package. Any device. Any platform. Anywhere.

PrimeX is a unified ecosystem of single-binary servers and tools, managed through a single CLI. Every component shares a common device identity, discovers peers automatically, and can be installed or updated with one command.

Quick Start

# Install the PrimeX CLI
npm install -g @primsfabrum/primex

# Install any server component
primex install conduit
primex install tunnel
primex install edge

# Update everything
primex update all

Core Components

PrimeX Core

Component Binary Description Status
PrimeX CLI primex / px Unified installer, updater, and device identity manager for the entire suite. ✅ Stable
PrimeX Conduit pxc Zero-config LAN discovery, secure key exchange, and SSH auth broadcast tool. Finds your devices so you don't have to. 🚧 Starting

Connectivity

Component Binary Description Status
PrimeX Gateway pxg SSH Server ⏳ Pending
PrimeX Reach pxr SSH Client ⏳ Pending
PrimeX Mount pxm SSHFS Server — mount remote filesystems over SSH ⏳ Pending
PrimeX Transfer pxt SFTP Server ⏳ Pending
PrimeX Relay pxrl FTP Server ⏳ Pending
PrimeX Tunnel pxtn VPN Server ⏳ Pending
PrimeX Link pxl VPN Client ⏳ Pending
PrimeX Edge pxe Reverse Proxy ⏳ Pending

Infrastructure

Component Binary Description Status
PrimeX Resolve pxrs DNS Server ⏳ Pending
PrimeX Serve pxs HTTP Server ⏳ Pending
PrimeX Store pxst SQL Server ⏳ Pending
PrimeX Cache pxch Cache Server ⏳ Pending
PrimeX Origin pxo Git Server ⏳ Pending

Messaging

Component Binary Description Status
PrimeX Send pxsd SMTP Server ⏳ Pending
PrimeX Inbox pxi IMAP Server ⏳ Pending
PrimeX Fetch pxf POP3 Server ⏳ Pending

PrimeX Conduit — The Flagship

Conduit is the first component under active development and the foundation for all future PrimeX servers. It solves a real problem: you have devices scattered across networks, subnets, and NAT boundaries, and you need instant, secure shell access to any of them without memorizing IPs or manually exchanging keys.

The Problem

You have an unlocked Android phone with root access, a MacBook Pro with broken Wi-Fi tethered through a Proxmox host, a Windows 11 Pro work PC, and a home lab rack running multiple VMs across different subnets. You need to reach any device, from anywhere, at any moment, without a pre-configured VPN or static IP map.

How Conduit Solves It

  1. Run the Beacon on any device you want to connect to (Android phone, Proxmox host, VM).
  2. Run the Agent on the device you connect from (MacBook, Windows PC).
  3. The Agent scans the local network and discovers all Beacons automatically.
  4. Select a device. Authenticate once. Your permanent device public key is deployed.
  5. From then on, standard ssh <alias> works. One identity. Full audit trail.

Flow

┌──────────────────────────────────────────────────────┐
│ BEACON (target device)                               │
│   $ conduit beacon --name android-phone             │
│   → Broadcasts presence via UDP multicast           │
│   → Listens for authenticated key deployment        │
└──────────────────────┬───────────────────────────────┘
                       │
          UDP Multicast (auto-discovered)
                       │
┌──────────────────────▼───────────────────────────────┐
│ AGENT (your laptop)                                  │
│   $ conduit agent discover                           │
│   → Finds: [1] android-phone  [2] proxmox-host      │
│   → User selects device, provides credentials       │
│   → Public key deployed via secure TLS handshake    │
│   → SSH config alias saved automatically            │
│                                                      │
│   $ ssh android-phone                                │
│   → Connected.                                       │
└──────────────────────────────────────────────────────┘

Key Properties

Property Detail
Zero-Config No IP addresses, no DNS, no static host files. Devices find each other.
Device Identity Each device generates a single Ed25519 keypair. One fingerprint across all PrimeX components and all target servers.
Auditability Every SSH connection traces back to a specific device identity. Know exactly what key belongs to what device.
InstaConnect Mode Trusted servers can auto-accept key deployment. Untrusted devices prompt for confirmation.
Cross-Platform Linux, macOS, Windows, Android (Termux), iOS (ish). Anywhere Bun or Node runs.

Design Philosophy

  • Single Binary, No Daemons: Every PrimeX component is a self-contained binary. No background services unless you choose to run one.
  • Shared Identity: One keypair per device, used across all PrimeX components. Install Conduit, then Tunnel, then Edge — same identity, zero reconfiguration.
  • Discoverable by Default: Every PrimeX server embeds a Conduit Beacon. Run primex serve and it appears in conduit agent discover automatically.
  • Offline-First: Discovery works on LAN without internet. No cloud dependency. No phone-home.
  • Bun + Node Compatible: Built with Bun for development speed. Published as standard Node-compatible packages to your Forgejo NPM registry.

Installation

# Configure registry (one-time)
npm config set @primsfabrum:registry https://closed-source.carstens.ltd/api/packages/PrimusFabrum/npm/
echo "//closed-source.carstens.ltd/api/packages/PrimusFabrum/npm/:_authToken=YOUR_TOKEN" >> ~/.npmrc

# Install the CLI
npm install -g @primsfabrum/primex

# Use it
primex --help

Development

git clone https://closed-source.carstens.ltd/PrimusFabrum/PrimeX.git
cd PrimeX
bun install
bun run dev

See CONTRIBUTING.md for branch strategy, commit conventions, and PR workflow.

License

FCSL — Primus Fabrum Closed-Source License. See LICENSE for terms.

Credits

Created and maintained by Primus Fabrum.

Dependencies

Dependencies

ID Version
chalk ^5.4.0
commander ^12.1.0
prompts ^2.4.2
tar ^7.4.0
yaml ^2.7.0

Development dependencies

ID Version
@types/bun latest

Keywords

primex cli server-suite ssh package-manager
Details
npm
2026-05-13 09:42:53 +02:00
0
Primus Fabrum
FCSL
18 KiB
Assets (1)
primex-0.1.2-canary.c8e3795.tgz 18 KiB
Versions (9) View all
0.1.2-next.4ebf4c6 2026-05-13
0.1.2-canary.86d9229 2026-05-13
0.1.2-canary.ff9a36c 2026-05-13
0.1.2-canary.bffab13 2026-05-13
0.1.2-canary.c8e3795 2026-05-13