How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/even-realities/everything-evenhub --skill cli-referenceBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
Even Hub CLI Reference
Installation
bash
# Install as dev dependency (recommended)
npm install -D @evenrealities/evenhub-cli
# Install globally
npm install -g @evenrealities/evenhub-cli
# Or run without installing via npx
npx @evenrealities/evenhub-cli <command>Current version: v0.1.11
When installed as a dev dependency, use npx evenhub <command> to run. When installed globally, use evenhub <command> directly.
evenhub login
Authenticate with your Even Hub account. Credentials are saved locally for future use.
bash
evenhub login
evenhub login -e your@email.com| Option | Description |
|---|---|
-e, --email <email> | Your account email |
evenhub init
Generate a starter app.json manifest file.
bash
evenhub init
evenhub init -d ./my-project
evenhub init -o ./config/app.json| Option | Description |
|---|---|
-d, --directory <dir> | Directory to create file in (default: ./) |
-o, --output <path> | Output file path (overrides --directory) |
evenhub qr
Primary development command. Generates a QR code pointing to your local dev server. Auto-detects local IP and remembers previous settings on subsequent runs.
Scan the QR code with the Even Realities App on your phone — the app loads on your glasses with hot reload.
bash
evenhub qr
evenhub qr --url "http://192.168.1.100:5173"
evenhub qr -i 192.168.1.100 -p 5173 --path /my-app
evenhub qr --url "http://192.168.1.100:5173" -e| Option | Description |
|---|---|
-u, --url <url> | Full URL (ignores other URL options) |
-i, --ip <ip> | IP address or hostname |
-p, --port [port] | Port number |
--path <path> | URL path |
--https | Use HTTPS instead of HTTP |
--http | Use HTTP (default) |
-e, --external | Open QR in external program instead of terminal |
-s, --scale <n> | Scale factor for file output (default: 4) |
--clear | Clear cached scheme, IP, port, and path |
evenhub pack
Package your app for distribution on Even Hub.
bash
evenhub pack app.json dist -o myapp.ehpk
evenhub pack app.json ./build --check| Argument/Option | Description |
|---|---|
<json> | Path to app.json manifest |
<project> | Path to built output folder |
-o, --output <file> | Output filename (default: out.ehpk) |
--no-ignore | Include hidden files (dotfiles) |
-c, --check | Check if package_id is available on Even Hub |
Shell Completions
bash
evenhub --completion-bash
evenhub --completion-zsh
evenhub --completion-fishapp.json Manifest Reference
Field Table
| Field | Type | Required | Rules |
|---|---|---|---|
package_id | string | Yes | Reverse-domain, lowercase, no hyphens, min 2 segments, each segment starts with a lowercase letter |
edition | string | Yes | Must be "202601" |
name | string | Yes | Max 20 characters |
version | string | Yes | Semver x.y.z |
min_app_version | string | Yes | Min Even Realities App version (e.g., "2.0.0") |
min_sdk_version | string | Yes | Min SDK version (e.g., "0.0.12") |
entrypoint | string | Yes | Path to HTML entry relative to build folder |
permissions | array | Yes | Array of permission objects. Can be [] |
supported_languages | array | Yes | Valid: en, de, fr, es, it, zh, ja, ko |
Template
json
{
"package_id": "com.example.myapp",
"edition": "202601",
"name": "My App",
"version": "0.1.0",
"min_app_version": "2.0.0",
"min_sdk_version": "0.0.12",
"entrypoint": "index.html",
"permissions": [],
"supported_languages": ["en"]
}Permissions Format
Permissions is an array of objects. Each object requires:
name(string, required) — permission identifierdesc(string, required) — description, 1-300 characterswhitelist(string[]) — only valid for thenetworkpermission
Valid permission names: network, location, g2-microphone, phone-microphone, album, camera
Common mistake: permissions must be an array of objects, NOT a key-value map.
json
// Correct
"permissions": [
{ "name": "network", "desc": "Access the internet", "whitelist": ["https://api.example.com"] },
{ "name": "location", "desc": "Access device location" }
]
// Wrong — do NOT use a map/object
"permissions": {
"network": "Access the internet"
}Troubleshooting (evenhub pack)
| Error | Fix |
|---|---|
Invalid package id | Lowercase reverse-domain, min 2 segments, no hyphens, no uppercase, no leading numbers |
name: must be 20 characters or fewer | Shorten app name |
version: must be in x.y.z format | Use three-part semver |
min_app_version/min_sdk_version: expected string, received undefined | Both fields are required — add them to app.json |
permissions: each permission must be an object | Use array of objects with name + desc fields |
supported_languages: invalid language | Use lowercase ISO codes from the supported set |
Entrypoint file not found | Ensure the file exists in the build folder |
Project folder not found | Run npm run build first |
Task
$ARGUMENTS
