Pre-compiling .useless files
Before publishing, resolve every import/export in your script down to
one flat file:
upkg pre-compile file.useless
This produces a single self-contained .useless file with no remaining imports. That
compiled output is what you paste into Create Package. Building
or using that compiler isn't something this site handles — see the UselessOS reference docs
for how import/export resolution works.
GET /install/:id — public packages
Fetches a public package's compiled contents as plain text.
GET /install/xyzcorppkg HTTP/1.1 Host: uselesspkg.omniasync.com
| Status | Meaning |
|---|---|
| 200 | Body is the raw .useless file contents (Content-Type: text/plain) |
| 403 | Package exists but is private — use POST with credentials instead |
| 404 | No package with that id |
| 429 | Rate limit exceeded for your IP |
POST /install/:id — public or private packages
Works for both public and private packages. Requires a JSON or form body with a valid account's
email and password.
POST /install/xyzcorppkg HTTP/1.1
Host: uselesspkg.omniasync.com
Content-Type: application/json
{"email": "you@example.com", "password": "your-password"}
| Status | Meaning |
|---|---|
| 200 | Body is the raw .useless file contents |
| 401 | Missing or invalid email/password |
| 404 | No package with that id |
| 429 | Rate limit exceeded for your IP |
CORS is wide open on
/install/* (Access-Control-Allow-Origin: *) so
scripts and tools running in any browser context can install packages directly. Requests are
rate-limited per IP address (default: 30 requests / 60 seconds) — excess requests get a
429 with a short plain-text message.