StableAdapters

JetBrains Adapter

The FORG JetBrains plugin works across all JetBrains IDEs: IntelliJ IDEA, PyCharm, GoLand, WebStorm, Rider, CLion, and others. It captures AI Assistant interactions, inline completions, and chat sessions.

Prerequisites

  • IntelliJ Platform 2023.3 or later
  • JetBrains AI Assistant plugin installed and activated
  • FORG CLI installed and activated

Installation

Install from the JetBrains Marketplace:

  1. Open your JetBrains IDE
  2. Go to Settings → Plugins → Marketplace
  3. Search for "FORG"
  4. Click Install and restart the IDE

Or install via the JetBrains CLI:

# IntelliJ IDEA
idea installPlugins pro.forg.forg-jetbrains

Configuration

After install, go to Settings → Tools → FORG:

Agent port:    6247          (must match FORG_PORT)
Project ID:    proj_xxx      (optional, for per-project attribution)
Log level:     info

Settings can also be managed via idea.properties:

forg.agent.port=6247
forg.project.id=proj_my-idea-project
forg.log.level=info

What gets captured

  • JetBrains AI Assistant chat (all models)
  • Inline code completions (Full Line and multi-line)
  • AI-generated code actions (refactor, explain, generate tests)
  • Model, tokens (estimated), latency, and cost per interaction

Verification

Check the FORG icon in the status bar (bottom right of the IDE window). A green checkmark indicates the agent is connected. Click the icon for a signal summary of the current session.

forg status --adapter
# Adapter:     forg-jetbrains
# IDE:         IntelliJ IDEA 2024.1
# Last signal: 12s ago

Multi-project workspaces

If you open multiple projects in separate windows, each window is treated as a separate FORG session. Set forg.project.id per project in idea.properties or via the per-project FORG settings panel.

Troubleshooting

IssueResolution
Status bar icon missingEnable "FORG" in View → Status Bar Widgets.
Agent connection failsCheck forg status. Ensure no firewall is blocking localhost:6247.
Token counts seem highJetBrains AI tokens include context window prefill. This is expected.
© 2026 UpgradIQ, Inc.Edit this page on GitHub