VS Code Based IDE Integration

Also works with Cursor and Windsurf!

This guide applies to VS Code, Cursor, and Windsurf - they all use the same extension since they’re built on VS Code.

---

Installation

1. Open Extensions (Ctrl+Shift+X)
2. Search for “GalataJ”
3. Click Install

Requirements

• VS Code 1.80 or later
• Java JDK 11+ for your application

---

Start Profiling

1. Run your Java application
2. Open Command Palette (Ctrl+Shift+P)
3. Run “GalataJ: Start Profiling”
4. Select the JVM from the list

The extension automatically handles everything:

• ✅ Starts the controller
• ✅ Discovers running JVMs
• ✅ Attaches the profiler agent

---

View Inline Metrics

Performance metrics appear directly above your methods:

Metrics shown:

• Execution time - Average and max time
• Call count - Number of invocations
• Memory - Allocations per call
• Trend - Performance change indicator

Hover for Details

Hover over any method to see detailed metrics:

---

GalataJ Panel

Click the GalataJ icon in the sidebar to open the panel:

Panel features:

• View all profiled methods
• Sort by execution time, call count, or trend
• Filter by package or class
• Click to navigate to method source
• Connection status indicator

---

Stop Profiling

Open Command Palette (Ctrl+Shift+P) and run “GalataJ: Stop Profiling”.

---

Understanding Metrics

Execution Time

Avg = cumulative average since profiling started
Max = highest time in recent window

Trend

↑ Positive = getting slower
↓ Negative = getting faster

Call Count

Total invocations since profiling started

Allocations

Memory allocated per method call

---

Extension Settings

Open File → Preferences → Settings and search for “GalataJ”:

Setting	Description
galataj.cliPath	Path to CLI (if not in PATH)
galataj.autoStart	Auto-start controller
galataj.showInlineHints	Enable/disable inline hints

---

Troubleshooting

JVM Not Showing Up?

Make sure your Java application is running, then try “GalataJ: Refresh JVMs” from Command Palette. If it still doesn’t appear, run galataj doctor in terminal.

Issue	Solution
No metrics appearing	Check status bar shows “GalataJ: Connected”
Metrics not updating	Try “GalataJ: Restart Profiling”
Extension not activating	Reload VS Code window

For more help, see Troubleshooting Guide.

---

Next Steps

• IntelliJ Integration - Use GalataJ in IntelliJ
• Docker Profiling - Profile containerized apps
• Configuration - Customize settings