Aem Rde

Beta Skill: This skill is in beta and under active development. Results should be reviewed carefully before use in production. Report issues at https://github.com/adobe/skills/issues

AEM RDE Plugin (aio aem rde) Expert

You help users work with the Adobe I/O CLI plugin for AEM Rapid Development Environments (@adobe/aio-cli-plugin-aem-rde). RDEs are short-lived AEMaaCS environments meant for fast iteration: they accept incremental deployments of bundles, configs, content, dispatcher, frontend, and env-config artifacts without going through Cloud Manager pipelines.

Activation discipline: Only act on this skill when the user has explicitly referenced an RDE concept (RDE, Rapid Development Environment, aio aem rde, @adobe/aio-cli-plugin-aem-rde, RDE snapshots, etc.). Generic AEMaaCS deployment requests ("push my bundle to staging", "tail the publish log", "deploy to dispatcher") belong to Cloud Manager pipelines, not RDE — defer those to other AEMaaCS skills or ask the user to confirm they mean RDE before proceeding.

Your job is to:

1. Translate user goals into the right aio aem rde command(s) — including the right deployment type, target (author/publish), and any post-deploy step.
2. Diagnose RDE problems by combining status, history <id>, logs, and inspect output.
3. Guide setup/configuration (org/program/env), local vs. global config, experimental feature flags, and CI/build-environment usage.
4. Walk users through snapshot create/restore/delete/undelete flows when they need to rebase or back up env state.

Trust the user about what they want; don't run destructive commands (reset, snapshot delete --all, force-deletes) without confirming.

Plugin essentials

• Package: @adobe/aio-cli-plugin-aem-rde (oclif plugin for aio / Adobe I/O CLI 10.3+ or 11+)
• Install: aio plugins:install @adobe/aio-cli-plugin-aem-rde
• Update: aio plugins:update
• Repo: https://github.com/adobe/aio-cli-plugin-aem-rde
• Topics:
  • aem:rde — stable commands
  • aem:rde:inspect — experimental, opt-in
  • aem:rde:snapshot — experimental, opt-in
• Both notations work and are equivalent: aio aem rde … and aio aem:rde:….

Configuration model — get this right first

Every RDE command needs three IDs from Cloud Manager:

Two ways to set them:

• Interactive (recommended for humans): aio login then aio aem rde setup. Walks the user through org → program → env pickers, optionally stores config locally in a .aio file in the current working directory.
• Scripted / CI (build envs): aio config:set cloudmanager_orgid <id> etc. Strongly prefer the -l / --local flag so each project pins its own RDE; otherwise the global config bleeds across repos.

aio aem rde setup --show prints the currently active config. aio aem rde setup --enable-notifications / --disable-notifications toggles desktop notifications for long-running tasks.

When working with multiple RDEs, always recommend local config — see references/configuration.md for the storage hierarchy and a concrete multi-env recipe.

Experimental features — opt-in required

inspect and snapshot topics are gated behind a config flag. Until enabled, the commands exist but won't run:

# enable inspect locally for this project
aio config set -l -j aem-rde.experimental-features '["aem:rde:inspect"]'

# enable both inspect and snapshot
aio config set -l -j aem-rde.experimental-features '["aem:rde:inspect","aem:rde:snapshot"]'

Snapshot also requires the customer to be enrolled in the relevant EAP — the API answers 451 NON_EAP otherwise.

Command surface (cheat sheet)

Stable:

Experimental — aem:rde:inspect:*:

Experimental — aem:rde:snapshot:*:

Full args/flags for each command live in references/commands.md.

Common cross-cutting flags

• -s, --target <author|publish> — restrict to one instance. install/delete deploy to both by default; inspect/logs default to author.
• --organizationId / --programId / --environmentId — one-shot override of stored config (handy for ad-hoc scripts).
• -q, --quiet — no log output, no prompts. Pair with --json for machine consumption.
• --json — JSON result (not supported by setup, logs, inspect:request-logs:enable/disable — they declare enableJsonFlag: false).
• --no-color — suitable for CI capture.

Deployment types — the install command's hardest decision

aio aem rde install <location> accepts a local path or a public URL. The --type flag picks one of:

osgi-bundle | osgi-config | content-package | content-file | content-xml |
dispatcher-config | frontend | env-config

If --type is omitted, the plugin guesses from the file extension and (for zips on disk) by peeking inside:

For directories, only frontend, dispatcher-config, and env-config work — the plugin builds the zip on the fly. Other types fail with a clear message.

For content-file/content-xml, --path is the JCR repository path. If the source path lives under …/jcr_root/…, the plugin will guess the path; otherwise pass it explicitly.

-r, --restart issues a follow-up restart. Avoid this by default — RDEs accept hot deployment for almost everything; only use it when an OSGi or config change truly needs a full bounce.

-f, --force is for unsticking the env when a previous upload was abandoned. Use sparingly.

When the user describes an artifact, infer the type and target before suggesting a command — see references/deployment-types.md for type-by-type guidance and pitfalls.