Operational CLI for diagnosing, reproducing, and fixing Liferay environments.
ldev is an operational CLI for Liferay maintenance work. It helps you inspect the portal, diagnose failures, reproduce production issues locally, apply fixes safely, and verify the result without depending on the UI.
Install the CLI, initialize a local project, and run the first checks.
npm install -g @mordonezdev/ldev
ldev project init --name my-project --dir ~/projects/my-project
cd ~/projects/my-project
ldev setup
ldev start
ldev doctor- Understand the Environment —
ldev context,ldev status, andldev portal inventoryexpose the actual runtime and portal state. - Diagnose Faster —
ldev doctorandldev logs diagnosehelp isolate environment and runtime failures quickly. - Reproduce Production Locally — Docker, database, and worktree workflows help bring real issues into a controlled local setup.
- Apply Fixes Safely —
ldev deploy,ldev osgi, and related tooling support controlled runtime changes and verification. - Work with Structured Output — JSON output makes the same workflows usable for humans, scripts, and coding agents.
Use ldev in the same order you would handle a real Liferay issue:
ldev context --json
ldev doctor --json
ldev logs diagnose --json
ldev oauth install --write-env
ldev portal check
ldev portal inventory page --url /home --json
ldev osgi diag com.acme.foo.web
ldev deploy module foo-web
ldev portal checkAgents are a layer on top of the operational CLI, not the product story. Once the repo and environment are ready, ldev can bootstrap agent-facing assets such as AGENTS.md, CLAUDE.md, and managed skills while providing stable machine-readable workflows:
ldev ai install --target .
ldev context --json
ldev doctor --json
ldev portal inventory sites --json
ldev logs diagnose --jsonVisit the full documentation site: mordonez.github.io/ldev
git clone git@github.com:mordonez/ldev.git
cd ldev
npm install
npm run build:watch
npm linkTo explore without installing:
npx @mordonezdev/ldev --helpReleased under the Apache-2.0 License.