Help us improve
Share bugs, ideas, or general feedback.
From enonic-skills
Guides developers through Enonic CLI commands for sandbox management, project scaffolding, local development, app deployment, and CI/CD pipeline generation. Use when creating Enonic XP sandboxes, starting or stopping local instances, scaffolding projects from starters, running dev mode with hot-reload, deploying apps, or generating CI/CD workflows for Enonic apps. Don't use for writing XP application code (controllers, content types), querying via Guillotine or lib-content APIs, configuring non-Enonic environments, or Docker/Kubernetes deployment of XP.
npx claudepluginhub webmaxru/ai-native-dev --plugin enonic-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/enonic-skills:enonic-app-managerThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
**Step 1: Detect Workspace Context**
Provides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Structures git workflow practices for committing, branching, resolving conflicts, and organizing work across parallel streams. Use when making any code change.
Share bugs, ideas, or general feedback.
Step 1: Detect Workspace Context
node scripts/find-enonic-targets.mjs from the skill root to scan the current workspace for Enonic project markers (.enonic, build.gradle with com.enonic.xp plugin, gradle.properties with xpVersion).Step 2: Ensure CLI is Available
enonic --version.references/cli-reference.md for installation instructions and guide through the appropriate method for the detected OS:
npm install -g @enonic/clibrew tap enonic/cli && brew install --no-quarantine enonicwget -qO- https://repo.enonic.com/public/com/enonic/cli/installer/cli-linux/1.0.0/cli-linux-1.0.0.sh | shscoop bucket add enonic https://github.com/enonic/cli-scoop.git && scoop install enonicenonic --version.Step 3: Sandbox Management
references/cli-reference.md for the full sandbox command catalog.enonic sandbox create <name> [-v <version>] [-t <template>] [--skip-template] [-i <image>] [-f]enonic sandbox lsenonic sandbox start <name> [--detach] [--prod] [--debug]enonic sandbox stopenonic sandbox upgrade <name> -v <version>enonic sandbox delete <name> -fenonic sandbox copy <source> <target>-f flag for non-interactive execution when the version and name are known. Note: with -f, the sandbox auto-starts after creation unless --skip-start is also provided.-t <template> flag. Use --skip-template to create a bare sandbox with no pre-installed apps.-i <image> (e.g., enonic/xp:latest-sdk) to back the sandbox with a Docker image instead of a downloaded XP distribution. Requires docker on $PATH.Step 4: Project Scaffolding
enonic create <name> [-r <starter>] [-s <sandbox>] [-f]starter-vanilla, starter-headless, and starter-nextjs. Read references/cli-reference.md for the full list of options.enonic project sandbox <name>build.gradle and .enonic configuration after creation.Step 5: Development Workflow
enonic dev — starts the sandbox in detached mode and runs the app with file watching. Execute from the project root.enonic project buildenonic project deploy [sandbox-name] [-c] — use -c for continuous deployment.enonic project installenonic project testenonic project cleanenonic project gradle <tasks>enonic sandbox start <name> -dCtrl-C. The CLI will attempt to stop the detached sandbox automatically.Step 6: App Management on Running XP
references/cli-reference.md for the XP app commands.enonic app install --url <jar-url>enonic app install --file <path-to-jar>enonic app start <app-key>enonic app stop <app-key>--cred-file <path> (XP 7.15+), --client-key <path> + --client-cert <path> for mTLS (XP 7.15+), or set ENONIC_CLI_REMOTE_USER and ENONIC_CLI_REMOTE_PASS environment variables.Step 7: CI/CD Pipeline Generation
assets/enonic-ci.template.yml for the GitHub Actions workflow template..github/workflows/enonic-ci.yml in the project repository.Step 8: Troubleshooting
references/troubleshooting.md for common issues and resolutions.enonic sandbox ls — check sandbox status and XP version.enonic system info — check running XP instance details.8080 (HTTP) and 5005 (debug) availability.references/compatibility.md for CLI-to-XP version compatibility if version mismatch errors occur.scripts/find-enonic-targets.mjs returns no results, proceed with greenfield setup instructions rather than failing.enonic --version fails, guide through CLI installation per Step 2 before proceeding.references/compatibility.md and suggest a compatible XP version.references/troubleshooting.md for resolution steps.enonic dev fails, verify the project has a Gradle dev task (present in all official starters) and that the linked sandbox exists and is not already running in another terminal.