Skip to content

nddipiazza/robos / plugins/robos/skills/ide-java

ide-java

Verified

Automate 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 pass GPG 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:

  1. 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" }
      }
    }
    
  2. Register Webhook for Breakpoint Events:

    {
      "tool": "robos_ide_register_breakpoint_webhook",
      "arguments": {
        "webhookUrl": "http://127.0.0.1:9099/webhook/breakpoint"
      }
    }
    
  3. Launch Debug Session:

    {
      "tool": "robos_ide_run_config",
      "arguments": {
        "name": "Debug PetServiceTest",
        "mode": "debug"
      }
    }
    
  4. Inspect Suspended State on Breakpoint Event:

    {
      "tool": "robos_ide_get_thread_state",
      "arguments": {}
    }
    
  5. 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.
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: 465kUpdated Claude CodeCodexVerifiedInstall
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: 465kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 465kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 192kUpdated Claude CodeCodexVerifiedInstall