License Management

License Management

GalataJ offers Free and Pro tiers. Manage your license through the CLI.

License Tiers

Free Tier

Features:

• Inline performance metrics
• Live profiling tab
• Context detection (HTTP, DB, Scheduler)
• Add to Chat (AI integration)
• Runtime attach
• IntelliJ & VS Code support

Limitations:

• Limited session saves
• No session comparison
• No export capabilities
• No Local Docker support
• No live context file generation

Pro Tier

Features:

• Everything in Free
• Unlimited session saves
• Compare sessions
• Export JSON/CSV/HTML
• Local Docker Support
• Live Context File (.galataj/live-performance.md)
• Baseline-Live Compare File (.galataj/baseline-live-compare.md)
• Baseline tracking & regression detection
• Historical analysis
• Priority support

Purchasing a License

Step 1: Open Purchase Page

galataj license purchase

This opens the Lemon Squeezy checkout page in your browser.

Step 2: Complete Purchase

1. Select Pro license
2. Complete payment
3. Receive license key via email

Step 3: Activate License

galataj license login <your-license-key>

Example:

galataj license login abc123-def456-ghi789

Checking License Status

Human-Readable Format

galataj license status

Output:

License: Pro
Status: Active
Expires: 2025-12-31
Features: All Pro features enabled

JSON Format

galataj license status --json

Output:

{
  "tier": "pro",
  "status": "active",
  "expiresAt": "2025-12-31T23:59:59Z",
  "features": ["all"]
}

Validating License

Manual Validation

galataj license validate

Note: License validation is cached for 24 hours to reduce API calls.

Automatic Validation

• Validates on login
• Re-validates after cache expires (24 hours)
• Uses cached data when offline

License Information

Detailed Info

galataj license info

Shows:

• License tier
• Status
• Expiration date
• Features enabled
• Machine ID

Logging Out

Return to Free Tier

galataj license logout

Note: This removes the license key from local storage. You can log in again with the same key.

License Storage

Location

File: ~/.galataj/license.json

Format:

{
  "licenseKey": "abc123-def456",
  "tier": "pro",
  "expiresAt": "2025-12-31T23:59:59Z",
  "machineId": "xyz789",
  "validatedAt": "2025-01-01T00:00:00Z"
}

Security:

• Stored locally
• Not transmitted unnecessarily
• 24-hour validation cache

Configuration

API URL

Environment Variable:

export GALATAJ_LICENSE_API_URL=https://license.galataj.com/v1

Default: Cloudflare Worker endpoint

Machine ID

Auto-Generated:

• Created automatically on first use
• Stored in license file
• Used for license validation

Manual Override:

export GALATAJ_MACHINE_ID=abc123

Troubleshooting

License Validation Failed

Error: License validation failed or Network error

Solutions:

1. Check internet connection:

   ping license.galataj.com

2. Verify license key:

   galataj license status

3. Retry validation:

   galataj license validate

4. Check API URL:

   echo $GALATAJ_LICENSE_API_URL

Rate Limit Exceeded

Error: Rate limit exceeded

Solutions:

1. Wait before retrying:

   • License validation is cached for 24 hours
   • Wait a few minutes before retrying

2. Use cached license:

   • Offline mode uses cached data
   • Check ~/.galataj/license.json

License Expired

Error: License expired

Solutions:

1. Check expiration date:

   galataj license info

2. Renew license:

   • Purchase new license
   • Or contact support

Invalid License Key

Error: Invalid license key

Solutions:

1. Verify key format:

   • Check for typos
   • Ensure complete key

2. Re-enter key:

   galataj license login <correct-key>

Best Practices

1. Keep license key secure:

   • Don’t share license keys
   • Store securely

2. Monitor expiration:

   • Check status regularly
   • Renew before expiration

3. Use validation cache:

   • Avoid frequent validation calls
   • Let 24-hour cache work

4. Backup license file:

   • Copy ~/.galataj/license.json
   • Restore if needed

Next Steps

• Learn about CLI commands
• Read Configuration Guide
• See Troubleshooting Guide