cli-reference

Even Hub CLI Reference

Installation

# 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.

evenhub login
evenhub login -e your@email.com

evenhub init

Generate a starter app.json manifest file.

evenhub init
evenhub init -d ./my-project
evenhub init -o ./config/app.json

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.

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

evenhub pack

Package your app for distribution on Even Hub.

evenhub pack app.json dist -o myapp.ehpk
evenhub pack app.json ./build --check

Shell Completions

evenhub --completion-bash
evenhub --completion-zsh
evenhub --completion-fish

app.json Manifest Reference

Field Table

Template

{
  "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 identifier
• desc (string, required) — description, 1-300 characters
• whitelist (string[]) — only valid for the network permission

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.

// 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)

Task

$ARGUMENTS