/plugadvpl:deploy

Compile ADVPL/TLPP sources, restart the AppServer, and verify REST availability.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/JoniPraia/plugadvpl --skill plugadvpl-deploy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: /plugadvpl:deploy
Source: https://github.com/JoniPraia/plugadvpl/tree/main/skills/deploy
Command: npx skills add https://github.com/JoniPraia/plugadvpl --skill plugadvpl-deploy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual, error-prone steps of compiling ADVPL/TLPP, restarting the AppServer, and then optionally verifying that the REST endpoint is responding after the restart.

Core Features & Use Cases

  • Orchestrated dev cycle: Runs a guided wrapper that chains compile → AppServer restart via tq → optional REST smoke to avoid forgetting steps or running them out of order.
  • Clean-build guardrail: Uses && semantics so the AppServer restart only happens if compilation exits successfully.
  • Environment-aware deployment: Supports targeting a server configured with restart_cmd and recommends --all-envs when multiple environments exist (e.g., TCP vs REST envs).
  • Post-restart verification: Performs an optional smoke check against a REST endpoint and provides a troubleshooting path when runtime errors occur.

Quick Start

Run deploy for your source by compiling for the target server, restarting the AppServer, and then checking the REST endpoint readiness if needed.

Frequently Asked Questions about /plugadvpl:deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compile ADVPL sources and restart the Protheus AppServer in one step?

Compiling ADVPL and restarting the Protheus AppServer in one flow requires chaining the compile and restart commands with && semantics. The AppServer restart only triggers if the source compilation exits successfully, ensuring a clean build.

What is the best way to verify a REST endpoint after an AppServer restart?

Verifying a REST endpoint after an AppServer restart is done via a post-restart smoke test. This optional check queries the REST endpoint readiness and provides a troubleshooting path when runtime errors occur.

Do I need a specific restart command configured to deploy TLPP changes?

Deploying TLPP changes requires a server configured with a restart command. The deployment workflow relies on this configuration to restart the AppServer after a successful source compilation.

How to handle Protheus deployments with multiple environments like TCP and REST?

Handling Protheus deployments with multiple environments requires using the --all-envs option. This ensures the compile and restart flow targets both TCP and REST environments correctly.

Why does my Protheus AppServer restart fail after compiling ADVPL sources?

Your Protheus AppServer restart fails after compiling ADVPL sources if the compilation step does not exit successfully. The deployment flow uses clean-build guardrails with && semantics to prevent restarting on a failed build.