# GalataJ

> GalataJ is a lightweight Java profiler that shows method-level performance metrics inline in IntelliJ IDEA and VS Code. It lets developers profile, compare, and act on performance data without leaving their IDE. The core workflow is: Profile → Compare → Act.

## What is GalataJ?

GalataJ is a developer tool that instruments Java bytecode at the JVM level to collect method-level performance metrics. It displays these metrics as inline hints (CodeVision in IntelliJ, CodeLens in VS Code) directly above methods in the editor. No source code changes, annotations, JVM flags, or build plugins are required. The profiler attaches at runtime with ~3% overhead, making it suitable for development and testing environments.

## Core Features

### Inline Performance Metrics
- Shows Avg Time, Max Time, Call Count, Trend, and Memory Allocations above each method
- Color-coded trends: red (↑ slower / regression), green (↓ faster / improvement), gray (stable)
- Hover over metrics for full breakdown
- Real-time updates as the application runs

### Live Profiler Panel
- Dedicated panel/tool window showing all profiled methods
- Sortable columns: Method, Avg, Max, Calls, Trend, Alloc
- Filter by package or class name
- Click any method to jump to its source code

### Context Detection
- HTTP Endpoints: REST controller methods display endpoint paths
- Database Queries: Repository methods show query patterns
- Scheduled Tasks: @Scheduled methods display schedule info
- Async Methods: @Async methods show thread context

### Runtime Attach
- Attaches to running JVMs without restart
- No JVM flags or startup configuration needed
- Auto-discovery of local Java processes

### Session Management (Pro)
- Save profiling sessions with all method metrics, JVM info, timestamps
- Set any session as a baseline reference
- Compare two sessions side-by-side with regression indicators
- Session history with search, filter, delete, and export

### Export Capabilities (Pro)
- Export formats: JSON, CSV, HTML, Markdown
- Export individual sessions or comparison results

### AI Integration (Pro)
- Auto-generated context files in `.galataj/` project folder:
  - `live-performance.md` — real-time hotspots, trends, method-level context
  - `baseline-live-compare.md` — regression detection against baseline
- "Add to Chat" button next to each metric to copy context to AI assistants
- Built-in AI prompts: Analyze Regressions, Suggest Optimizations, Memory Analysis, IO vs CPU
- Custom AI prompts for frequently used analysis patterns
- Compatible with Cursor, ChatGPT, Claude, GitHub Copilot, and others

### Docker Support (Pro)
- Profile Java applications running in local Docker containers
- Automatic container discovery
- Supports Docker Desktop (Windows/macOS), Docker Engine (Linux), Docker Compose
- Two attachment methods: automatic attach (requires JDK image) or -javaagent approach (works with JRE)

### Health Check & Diagnostics
- One-click system health check: CLI, Java, Controller status
- Status indicators: OK (green), Warning (yellow), Error (red)
- Auto-fix button for common issues

## Supported Platforms

- **Java Versions:** JDK 8, 11, 17, 21, and later LTS releases
- **JVM Runtimes:** OpenJDK, Oracle JDK, Amazon Corretto
- **Operating Systems:** Windows, Linux, macOS
- **IntelliJ IDEA:** 2024.1+, Community and Ultimate editions
- **VS Code:** 1.80+, also compatible with Cursor and Windsurf

## CLI Commands

- `galataj doctor` — Diagnose system issues
- `galataj status` — Check running state
- `galataj jvms` — List available JVMs
- `galataj attach --pid <PID>` — Attach profiler to a JVM
- `galataj detach --jvm-id <ID>` — Stop profiling
- `galataj controller start` — Start controller service
- `galataj controller stop` — Stop controller service
- `galataj license status` — Check license status
- `galataj license login <KEY>` — Activate license

## Architecture

- **Plugin:** IDE extension for IntelliJ IDEA or VS Code
- **CLI:** Command-line tool for scripting and diagnostics
- **Controller:** Background service (HTTP port 9877, TCP port 9876)
- **Agent:** JVM instrumentation agent (`~/.galataj/agent/agent.jar`)

## Pricing

- **Free:** €0 forever — inline metrics, live profiling, context detection, Add to Chat, runtime attach, local JVM support
- **Pro:** €9/month or €89/year — unlimited sessions, session comparison, export, baseline tracking, AI context files, custom AI prompts, Docker support
- **Founders Lifetime:** €179 one-time — everything in Pro forever, direct developer support, priority feature requests
- **Team:** Contact for volume licensing, single invoice, custom duration

## Installation

- **IntelliJ IDEA:** JetBrains Marketplace → search "GalataJ Profiler" (Plugin ID: 30260)
- **VS Code / Cursor:** VS Code Marketplace → search "GalataJ" (Extension ID: GalataJ.galataj)
- **CLI (macOS/Linux):** `curl -fsSL https://download.galataj.com/install.sh | bash`
- **CLI (Windows):** `powershell -c "irm https://download.galataj.com/install.ps1 | iex"`

## Limitations

- Designed for development and testing, not production monitoring
- No distributed tracing, no production alerts
- Local Docker containers only (no remote Docker, no Kubernetes)
- One license per machine

## Documentation

- [Getting Started](https://galataj.com/docs/getting-started/overview/)
- [Installation](https://galataj.com/docs/getting-started/installation/)
- [Quick Start](https://galataj.com/docs/getting-started/quickstart/)
- [Features](https://galataj.com/docs/getting-started/features/)
- [Upgrade to Pro](https://galataj.com/docs/getting-started/upgrade-to-pro/)
- [IntelliJ IDEA Integration](https://galataj.com/docs/ide-integration/intellij/)
- [VS Code Integration](https://galataj.com/docs/ide-integration/vscode/)
- [Profiler Panel Guide](https://galataj.com/docs/guides/profiler-panel/)
- [Understanding Metrics](https://galataj.com/docs/guides/understanding-metrics/)
- [Session History](https://galataj.com/docs/guides/session-history/)
- [AI Integration Guide](https://galataj.com/docs/guides/ai-integration/)
- [Docker Guide](https://galataj.com/docs/guides/docker/)
- [Configuration Reference](https://galataj.com/docs/reference/configuration/)
- [CLI Reference](https://galataj.com/docs/reference/cli/)
- [Troubleshooting](https://galataj.com/docs/troubleshooting/)

## Links

- [Website](https://galataj.com)
- [Pricing](https://galataj.com/pricing/)
- [About](https://galataj.com/about/)
- [GitHub](https://github.com/yyusufaslan/galataj)
- [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/30260-galataj-profiler)
- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=GalataJ.galataj)
- [Privacy Policy](https://galataj.com/privacy/)
- [Terms of Service](https://galataj.com/terms/)
- [EULA](https://galataj.com/eula/)

## Contact

- Email: hello@galataj.com
- Support: support@galataj.com
- X (Twitter): https://x.com/yyusufaslandev
- LinkedIn: https://linkedin.com/in/yyusufaslan