Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
amplicode avatar

Amplicode Install

  • 118 installs
  • 105 repo stars
  • Updated July 27, 2026
  • amplicode/spring-skills

Find installed IntelliJ IDEA and GigaIDE paths on Windows so Amplicode or Spring tooling can be installed into the right IDE without manual hunting.

About

amplicode-install is an agent skill backed by a PowerShell detector that locates locally installed IntelliJ IDEA (Ultimate or Community) and GigaIDE on Windows. Solo builders shipping Spring or JVM apps with Amplicode often need a machine-readable list of valid IDE homes before plugins or marketplace steps run. The skill runs detect-ides.ps1 (or equivalent) and prints a JSON array of candidates on standard output, or an empty array when nothing is found. Bounded Invoke-WithTimeout and Find-ProductInfoFiles helpers keep scans from blocking indefinitely, which matters when agents automate repetitive environment setup. It fits Claude Code, Cursor, and Codex workflows where filesystem inspection and shell execution are allowed. Pair it with Amplicode marketplace or configuration skills once candidates are known. It does not install plugins by itself—it only discovers where installation should target.

  • PowerShell script scans Windows for IntelliJ IDEA Ultimate and Community editions
  • Detects GigaIDE installations alongside JetBrains products
  • Emits a UTF-8 JSON array of IDE candidates on stdout for downstream install steps
  • Uses bounded timeouts and depth limits so directory walks do not hang the agent
  • Skips reparse points and continues safely when individual probes time out

Amplicode Install by the numbers

  • 118 all-time installs (skills.sh)
  • Ranked #32 of 89 Java & JVM skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/amplicode/spring-skills --skill amplicode-install

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs118
repo stars105
Last updatedJuly 27, 2026
Repositoryamplicode/spring-skills

What it does

Find installed IntelliJ IDEA and GigaIDE paths on Windows so Amplicode or Spring tooling can be installed into the right IDE without manual hunting.

Files

SKILL.mdMarkdownGitHub ↗

amplicode-install

Installs the Amplicode IntelliJ plugin into all locally installed IntelliJ IDEA (Ultimate/Community) and GigaIDE installations the user picks.

What this skill does

1. Runs a platform-specific detection script that finds installed IntelliJ-based IDEs on the machine. 2. Filters down to IDEA Ultimate (`IU`), IDEA Community (`IC`), and GigaIDE. Skips everything else. 3. Filters out IDEs where Amplicode is already installed. 4. Asks the user which IDE(s) to install into when more than one candidate remains. 5. Invokes the standard JetBrains CLI: <ide-binary> installPlugins com.haulmont.amplicode https://amplicode.ru/marketplace. The IDE itself picks the right version for its build, downloads the ZIP, and unpacks it into the right plugins directory. 6. Tells the user to launch the IDE, open any project, and click the "Настроить Spring Agent" button on the Amplicode welcome screen. That button (and only that button) triggers MCP auto-config + spring-skills install.

What this skill does NOT do

  • It does not write any MCP client config. The Amplicode plugin needs a running MCP server inside the IDE to know the port — only the plugin itself can fill in the configs of supported agents. That happens when the user clicks "Настроить Spring Agent" on the welcome screen (not automatically on IDE start).
  • It does not install spring-skills or any agent-side skill packages. That is also done by the welcome-screen button.
  • It does not download or extract the plugin ZIP by hand. JetBrains' installPlugins CLI handles fetching, version matching against the IDE build, and unpacking.

Step-by-step

1. Run the detection script

The scripts live next to this SKILL.md under scripts/. Run the right one for the user's OS and parse its stdout as a JSON array; the script already filters down to compatible IDEs (IDEA Ultimate / Community / GigaIDE), so the agent only needs these fields per element: amplicodeInstalled, name, running, pid, hostsCurrentProcess, dataDirectoryName, exePath, appBundle.

  • macOS / Linux: bash scripts/detect-ides.sh
  • Windows: pwsh scripts/detect-ides.ps1 (fallback powershell if pwsh is not available)

If the JSON array is empty — tell the user no compatible IDE was found and stop.

2. Filter

  • Drop entries with amplicodeInstalled: true — never reinstall, never ask.
  • If nothing left — tell the user Amplicode is already installed in every compatible IDE and stop.

3. Pick targets

  • Exactly one candidate left: install into it without asking. Tell the user which IDE you are using.
  • Two or more: ask the user a multi-select question (using whichever interactive-prompt tool the client provides). Each option is one IDE (label = name). Do not add "all of them" as a separate option — multi-select already covers it. Recommend selecting all, but let the user decide.

3a. Handle running IDEs (auto-restart flow)

For each picked IDE, check the running flag from the detection JSON. Trust it — do not roll your own `pgrep` check; pgrep truncates long JVM command lines and gives false negatives. If running: true, the JetBrains CLI will fail with "Only one instance of IDEA can be run at a time."

Self-host check (do this first). For each picked IDE with running: true, look at hostsCurrentProcess. If true, you are running inside that IDE's terminal — sending SIGTERM to the IDE will kill you before installPlugins ever runs, leaving the user with a closed IDE and no plugin. Never offer auto-restart for such IDEs. Skip the question below for that IDE and go straight to the manual instructions described after "If the user picks the second option" — substitute the IDE's own exePath. Tell the user up front (in their language) why: "I'm running inside this IDE — if I close it, I die with it and the install step never runs. So you'll need to do this part yourself."

When at least one picked IDE has running: true and `hostsCurrentProcess: false`, offer the user an auto-restart flow for those IDEs. Phrase the user-facing question in the user's language (mirror whatever language the user has been chatting in); the wording below is the English baseline:

"<IDE name> is currently running. I can gracefully shut it down, install the plugin, and relaunch it. If the IDE has unsaved changes it will show a save dialog and refuse to exit — in that case I will stop and you handle it manually. OK?"

Ask a single-select question with two options:

  • "Yes — close it, install, relaunch" (Recommended)
  • "I will do it myself"

If the user picks the second option, do not stop silently and do not just ask them to "re-run this skill" — they may be running you from inside that very IDE, in which case re-running the skill after closing the IDE is impossible. Instead, give them the exact command and the post-install steps they need to perform themselves. Tell them (in their language):

Close the IDE yourself, then run this command in a terminal:

>

```
"<exePath>" installPlugins com.haulmont.amplicode https://amplicode.ru/marketplace
```

>

Substitute <exePath> with the IDE launcher path from the detection JSON (quote it — there are usually spaces). Wait for it to finish; exit code 0 means the plugin is installed.

>

Then open the IDE again. On any open project:
1. If the Amplicode welcome screen appears — click Настроить Spring Agent.
2. Otherwise open it manually via Find Action (Cmd+Shift+A on macOS, Ctrl+Shift+A on Windows/Linux) → type Spring Agent Toolkit → Enter, then click Настроить Spring Agent.
3. After that, restart the MCP client you are using (so it picks up the new MCP server config).

Then stop the skill.

If the user agrees to auto-restart, for each running picked IDE do graceful quit → wait → install → relaunch:

Quit (SIGTERM, never SIGKILL):

  • macOS / Linux: kill -TERM <pid>
  • Windows: taskkill /PID <pid> (no /F)

Wait for shutdown by polling: re-run the detect script and look for the same dataDirectoryName. The IDE is fully down when running: false (the .pid file is removed). Poll every 5 seconds for up to 30 seconds — do NOT poll every second, that's just noise.

If still running after 30 seconds — stop. Tell the user (in their language): "The IDE didn't shut down within 30 seconds — there's probably an unsaved-changes dialog open. Finish saving/exiting it manually, then re-run this skill." Do not retry, do not force-kill.

Install as described in step 4.

Relaunch:

  • macOS: open -a "<appBundle>" (this is what appBundle is for; falls back to open -a "<exePath>" if missing).
  • Linux: nohup "<exePath>" >/dev/null 2>&1 & (detach from the agent process group).
  • Windows: Start-Process -FilePath "<exePath>" from PowerShell, or start "" "<exePath>" from cmd.

4. Install

For each picked IDE, run:

"<exePath>" installPlugins com.haulmont.amplicode https://amplicode.ru/marketplace

Notes:

  • Run it as a normal Bash call. Always quote exePath — it commonly contains spaces.
  • Do NOT run this while that IDE is open by the user — JetBrains' CLI may behave unpredictably with a running instance. If you suspect the IDE is running, ask the user to close it first.
  • If multiple targets — run them sequentially, not in parallel. Each invocation needs to write to that IDE's plugins directory.
  • Treat a non-zero exit code as failure for that IDE. Show the user the stderr and continue with the remaining IDEs.

5. Wrap up

Tell the user the following (translate it into the user's language — mirror whatever language they have been chatting in):

Amplicode plugin installed into: <list>.

>

Next:
1. Open any project in the IDE — the Amplicode welcome screen should appear automatically.
If it does not, open it manually: Find Action (Cmd+Shift+A on macOS, Ctrl+Shift+A on Windows/Linux) → type Spring Agent Toolkit → Enter.
2. Click the "Настроить Spring Agent" button on that screen. The plugin will then write the Amplicode MCP server into the configs of the supported agents and install spring-skills. Without clicking this button, MCP is not configured. The welcome screen only shows up on an open project, not on the IDE's start window.
3. Restart the MCP client you are currently using. Most clients read MCP config only at startup, so the newly added amplicode server is not visible in the current session. After the restart, check the client's MCP server list.

Keep Настроить Spring Agent and Spring Agent Toolkit verbatim in the translated message — they are literal labels rendered in the IDE's UI, not strings to localize.

6. Detect failure of step 5 (optional, if the client exposes its MCP server list to you)

After the user restarts their MCP client and continues the conversation, if you can introspect the list of configured MCP servers and amplicode is not present, the user most likely skipped the welcome-screen button. Tell them (in their language):

Looks like the amplicode MCP server isn't connected on your side. That means the welcome-screen button wasn't pressed yet. Open any project in the IDE, then run Find Action (Cmd+Shift+A / Ctrl+Shift+A) → Spring Agent Toolkit → click Настроить Spring Agent on the screen that opens. Then restart this client again.

Related skills

Java & JVMintegrationsbackend

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.