Even G2 dev workspace: docs snapshot (28 pages), README, toolchain notes

docs/pages/reference_cli.md

@@ -0,0 +1,112 @@
+CLI | Documentation
+    
+    
+    
+- 
+    
+- 
+    
+    
+    
+- 
+    
+- 
+    
+- 
+    
+- 
+    
+    
+  
+  
+    Skip to contentDocumentationSearch⌘CtrlK Main Navigation PortalThemeMenuReturn to top Sidebar Navigation 
+## Get Started
+Overview
+### Quickstart
+Sign inHardwareInstall Node.js & npmInstall Even Hub toolingYour First AppTemplatesArchitecture
+## Build
+Page LifecycleDisplay & UI SystemUI/UX Design GuidelinesDevice APIsContextual MenuNetworkingBackground & Lifecycle
+## Test
+SimulatorLocal TestingPrivate TestingBeta Testing
+## Ship
+Packaging & DeploymentApp Submission & QA Guidelines
+## Reference
+GlossaryCLIVersioning PolicyChangelogFAQ
+## AI Tooling
+Claude CodeOn this pageLast updated: 2026-08-20The CLI (v0.1.14) handles QR sideloading, manifest scaffolding, and app packaging.
+## Installation ​
+Install globally so the evenhub binary is on your PATH:bash
+```
+npm install -g @evenrealities/evenhub-cli
+```
+Alternatively, pin the version per-repo:bash
+```
+npm install -D @evenrealities/evenhub-cli
+```
+npm: @evenrealities/evenhub-cli
+### eh shortcut ​
+The CLI also installs eh as a shorter alias. The two are interchangeable:bash
+```
+eh qr --url ...    # same as: evenhub qr --url ...
+eh pack app.json dist
+eh init
+```
+
+## Commands ​
+
+### evenhub init ​
+Generate a starter app.json manifest in the current or specified directory.bash
+```
+evenhub init
+evenhub init -d ./my-project
+evenhub init -o ./config/app.json
+```
+ | 
+|  | Option | Description
+|  | -d, --directory <dir> | Directory to create the file in (default: ./)
+|  | -o, --output <path> | Output file path (overrides --directory)
+### evenhub qr ​
+Generate a QR code for sideloading your app during development.bash
+```
+# Simplest usage - provide the full URL
+evenhub qr --url "http://192.168.1.100:5173"
+
+# Or build the URL from parts
+evenhub qr -i 192.168.1.100 -p 5173 --path /my-app
+
+# Output to a file instead of terminal
+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 pathScan it with the Even Realities App. Your app loads on the glasses with hot reload live.
+### evenhub pack ​
+Package your built app into an .ehpk file for distribution.bash
+```
+evenhub pack app.json dist -o myapp.ehpk
+```
+ | 
+|  | Argument / Option | Description
+|  | <json> | Path to your app.json manifest
+|  | <project> | Path to your built output folder (dist, build, etc.)
+|  | -o, --output <file> | Output filename (default: out.ehpk)
+|  | --no-ignore | Include hidden files (dotfiles)
+|  | -c, --check | Check if the package_id is available on Even Hub
+|  | --sdk-ver <version> | SDK version you built against; the CLI reads its minAppVersion from npm and stamps it as the .ehpk min_app_version floor. Omit to use the latest published SDK.
+|  | --enforce-manual-version | Stamp min_app_version from app.json as-is, even below the SDK floor. Local testing only; produces a non-submittable build.min_app_version is derived from your SDK version at pack time (CLI 0.1.14+) - pin it with --sdk-ver. See Auto-deriving min_app_version for the resolution rules, warnings, and offline fallback.Since 0.1.14 a failed pack exits non-zero, so a packaging step in CI fails the run instead of passing silently on a missing .ehpk.See Packaging & Deployment for the full app.json schema, validation rules, and troubleshooting guide.
+## Shell completions ​
+Generate completions for your shell:bash
+```
+evenhub --completion-bash   # Bash
+evenhub --completion-zsh    # Zsh
+evenhub --completion-fish   # Fish
+```
+PagerPrevious pageGlossaryNext pageVersioning Policy