nddipiazza/robos / .agents/skills/ide-java
ide-java
VerifiedAutomate Java development in IntelliJ IDEA over the RobOS port 63343 IPC/MCP bridge. Create secret-secured run/debug configurations, trigger breakpoints, inspect paused thread stacks and local variables, and spin up ephemeral multi-project workspaces.
Java IDE Automation & Debugger Skill (IntelliJ IDEA Bridge)
Connects AI coding agents directly into JetBrains IntelliJ IDEA via the RobOS port 63343 IPC and Model Context Protocol (ide-bridge-mcp). Use this skill to automate Java workflows:
- Secret-Managed Run/Debug Configurations: Configure Maven, Gradle, Spring Boot, or JUnit run configs with runtime UNIX
passGPG secret injection (zero plaintext secrets on disk). - Interactive Breakpoint Debugging: Set breakpoints at reproduction sites and pause execution during reproduction tests.
- Paused Thread & Variable Inspection: Extract thread call stack frames, parameter values, and heap objects from suspended Java threads.
- Breakpoint Webhooks: Register webhook callbacks to be notified immediately when a breakpoint triggers.
- Ephemeral Multi-Project Workspaces: Orchestrate multi-repo project roots in IntelliJ IDEA with optional immediate debug launching and auto-destroy cleanup upon session completion.
Input
$ARGUMENTS — Subcommand and options:
1. Create Run/Debug Configuration
ide-java create-config --name "<config-name>" --type <Application|JUnit|Maven|Gradle> [--project "<path>"] [--target "<class-or-command>"] [--env "<KEY=VAL>"] [--pass-secrets "<KEY=pass:path>"]
- Creates an IntelliJ run configuration.
- Secret references (e.g.
pass:acme/vaccine-gateway-mTLS) are resolved at runtime in-memory and never committed to.idea/runConfigurations/XML.
2. Run or Debug
ide-java debug --name "<config-name>" [--breakpoint "<file>:<line>"]
ide-java run --name "<config-name>"
- Dispatches execution in IntelliJ. In debug mode, attaches the debugger and suspends execution when breakpoints are reached.
3. Stop Active Configuration
ide-java stop --name "<config-name>"
- Terminates the running Java process and notifies the ephemeral workspace manager for session-end cleanup.
4. Inspect Paused Thread State
ide-java thread-state [--thread-id "<id>"]
- Fetches the active suspended Java thread, top stack frames, and evaluated local variables.
5. Register Breakpoint Webhook
ide-java webhook --url "<http-callback-url>"
- Registers an HTTP webhook endpoint to receive JSON notifications whenever a breakpoint is triggered.
6. Ephemeral Multi-Project Workspace
ide-java ephemeral-workspace --projects "<path1>,<path2>" [--auto-debug "<config-name>"] [--auto-destroy]
- Provisions a unified multi-project workspace in IntelliJ IDEA.
Procedure
Using MCP Protocol Tools (ide-bridge-mcp)
When using Model Context Protocol tools, invoke:
-
Create Configuration:
{ "tool": "robos_ide_create_run_config", "arguments": { "name": "Debug PetServiceTest", "type": "JUnit", "projectPath": "/workspace/petstore-api", "mainClassOrCommand": "com.acme.petshop.service.PetServiceTest", "env": { "SPRING_PROFILES_ACTIVE": "test" }, "passSecrets": { "MTLS_KEYSTORE": "pass:acme/vaccine-gateway-mTLS" } } } -
Register Webhook for Breakpoint Events:
{ "tool": "robos_ide_register_breakpoint_webhook", "arguments": { "webhookUrl": "http://127.0.0.1:9099/webhook/breakpoint" } } -
Launch Debug Session:
{ "tool": "robos_ide_run_config", "arguments": { "name": "Debug PetServiceTest", "mode": "debug" } } -
Inspect Suspended State on Breakpoint Event:
{ "tool": "robos_ide_get_thread_state", "arguments": {} } -
Spin Up Ephemeral Multi-Project Workspace:
{ "tool": "robos_ide_create_ephemeral_workspace", "arguments": { "workspaceId": "ws-petstore-polyglot", "projects": ["/workspace/petstore-api", "/workspace/petstore-web", "/workspace/shared-lib"], "autoRunConfig": "Debug PetServiceTest", "autoDestroyOnSessionEnd": true } }
Direct IPC Endpoints (Port 63343)
The RobOS IntelliJ plugin exposes these REST endpoints on http://127.0.0.1:63343:
GET /robos/health: Health status and plugin version.POST /robos/run-config/create: Create run config with pass secrets.POST /robos/run-config/run: Run or debug a configuration.POST /robos/run-config/stop: Stop execution.POST /robos/webhook/register: Register breakpoint webhook URL.GET /robos/debug/thread-state: Get paused thread stack frames & variables.POST /robos/workspace/ephemeral: Load multi-project workspace.GET /robos/workspace/destroy?workspaceId=<id>: Clean up ephemeral workspace.
Validation
- Ensure port 63343 responds:
curl http://127.0.0.1:63343/robos/health. - Verify secrets are masked/resolved without writing plaintext passwords to repository files.
- Verify breakpoint webhooks deliver valid JSON payloads with stack frames and local variables.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 465k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 465k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 465k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |