CLI Reference

For Advanced Users

Most users never need the CLI. The IDE plugin handles everything automatically. This reference is for automation, scripting, and troubleshooting scenarios.

When to Use CLI

Scenario	Why CLI?
IDE can’t find JVM	Run `galataj doctor`
Headless servers	No IDE available
Docker	Manual attach
Debugging	Check status, logs

Essential Commands

`galataj doctor`

Diagnose system issues. Run this first when something doesn’t work.

galataj doctor

✓ CLI: v1.0.0
✓ Java: Found (17.0.1)
✓ Controller: Found
✓ Agent: Found
✓ Controller: Running
✓ Ports: Available

`galataj status`

Check what’s running.

galataj status

Controller: Running (PID: 12345)
HTTP Port: 9877
TCP Port: 9876

Attached JVMs: 1
- abc123 (PID: 67890) - MyApp

`galataj jvms`

List available JVMs.

galataj jvms

Found 2 JVM(s):

1. com.example.MyApp
   ID: abc123
   PID: 12345

2. order-service
   ID: def456
   Environment: docker

`galataj attach`

Attach profiler to a JVM.

# By PID
galataj attach --pid 12345

# By JVM ID
galataj attach --jvm-id abc123

`galataj detach`

Stop profiling a JVM.

galataj detach --jvm-id abc123

Controller Management

# Start controller
galataj controller start

# Start with custom port
galataj controller start --port 8888

# Stop controller
galataj controller stop

License Commands

# Check status
galataj license status

# Activate license
galataj license login YOUR-LICENSE-KEY

# Open purchase page
galataj license purchase

# Validate license
galataj license validate

JSON Output

Most commands support --json for scripting:

galataj jvms --json
galataj status --json
galataj license status --json
galataj doctor --json

Exit Codes

Code	Meaning
0	Success
1	General error
2	Controller not running
3	JVM not found
4	Attach failed
5	License error