aem-ext-daemon

Local daemon for AEM Extension Builder. Connects your machine to the cloud UI so the builder can scaffold extensions, run CLI commands, and manage files on your local filesystem.

Quick Start

npx aem-ext-daemon

That's it. On first run the daemon will display a QR code and pairing URL. Open it in your browser to connect.

How It Works

1. The daemon runs on your machine and connects outbound to the cloud app via WebSocket
2. On first run, it generates a unique identity and a pairing code
3. You scan the QR code (or open the URL) in your browser to link the daemon to your session
4. Once paired, the cloud UI can send commands (file operations, git, AIO CLI) that execute locally
5. On subsequent starts, the daemon reconnects automatically — no re-pairing needed

Options

npx aem-ext-daemon [options]

  --server <url>       Cloud app URL (uses default if omitted)
  --workspace <path>   Set the workspace root directory
  --reset              Clear identity and force re-pairing
  --help, -h           Show help
  --version, -v        Show version

Prerequisites

• Node.js 18+
• AIO CLI (optional, for extension scaffolding): npm install -g @adobe/aio-cli

Config Location

• macOS/Linux: ~/.config/aem-ext-daemon/config.json
• Windows: %APPDATA%\aem-ext-daemon\config.json

Security

• The daemon only executes commands within the configured workspace directory
• All paths are validated to prevent traversal outside the workspace
• Communication uses WSS (TLS-encrypted WebSocket)
• Identity is verified with a 256-bit secret hashed server-side