restart-spring-boot

Name: restart-spring-boot
Availability: InStock
Author: jvm-skills

Restart Spring Boot apps via IntelliJ run configurations and wait for health checks.

135|25|Updated Feb 20, 2026

Search Tags:#restart #kotlin #jetbrains #spring-boot #health-check #intellij

Ready to run

npx skills add https://github.com/jvm-skills/jvm-skills --skill restart-spring-boot

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: restart-spring-boot
Source: https://github.com/jvm-skills/jvm-skills/tree/main/.junie/skills/restart-spring-boot
Command: npx skills add https://github.com/jvm-skills/jvm-skills --skill restart-spring-boot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Restart the Spring Boot app after Kotlin changes and ensure the server is fully ready before continuing.

Core Features & Use Cases

Stop the old app and wait for the port to be released.
Start the app via an IntelliJ JetBrains MCP run configuration and identify the correct configuration name.
Wait for readiness by polling a health endpoint (e.g., /actuator/health or root) and verify logs if a post-restart hook exists.
Project customization is guided by references/project.md for port, run configuration name, and log paths.

Quick Start

Copy SKILL.md into your project, move templates/restart-app.sh to scripts/restart-app.sh, make it executable, and run ./scripts/restart-app.sh to perform a full restart.

Frequently Asked Questions about restart-spring-boot

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

FAQPage Schema

How do I restart a Spring Boot application and wait for it to be ready?▼

To restart a Spring Boot application and ensure readiness, stop the old process, wait for the port to release, launch the IntelliJ run configuration, and poll the health endpoint until it passes.

How do I restart a Kotlin Spring Boot app using an IntelliJ run configuration?▼

You can restart a Kotlin Spring Boot app by executing a scripted restart flow that identifies and launches the correct IntelliJ JetBrains run configuration, then verifies readiness through health checks and logs.

What health check endpoint does the Spring Boot restart process poll for readiness?▼

The Spring Boot restart process polls the /actuator/health endpoint or the root endpoint to verify server readiness and reports success or failure based on the health endpoint response and application logs.

Do I need to configure project-specific settings to restart my Spring Boot application?▼

Yes, you need to configure project-specific context via references/project.md, which guides customization for the port number, IntelliJ run configuration name, and log paths used during the Spring Boot restart flow.

Why does my Spring Boot restart fail after Kotlin changes even when the port is released?▼

A Spring Boot restart can fail after Kotlin changes if the health endpoint does not pass or post-restart logs indicate errors, causing the readiness check to report failure despite the old process stopping and the port releasing correctly.