ContoxContox|Documentation

JetBrains IDE Integration

Contox integrates with JetBrains IDEs (IntelliJ IDEA, PyCharm, WebStorm, GoLand, Rider, etc.) via the Contox IntelliJ plugin. The plugin provides the same project memory capabilities as the VS Code extension: automatic git event capture, session management, and brain sync.

How it works

  1. The plugin monitors your git activity and captures commits, file changes, and session context
  2. At session end, you save your work directly from the IDE or via the CLI
  3. The brain document is kept in sync so your AI assistant always has current context

Prerequisites

  • Contox CLI installed: npm install -g contox-cli
  • CLI authenticated: contox login -k <your-api-key>
  • Project initialized: contox init -t <team-id> -p <project-id>

Install the plugin

Via JetBrains Marketplace

  1. Open Settings → Plugins → Marketplace
  2. Search for Contox
  3. Click Install and restart the IDE

Via local installation (early access)

If the plugin is not yet published on the Marketplace:

  1. Download the .zip plugin file from your Contox dashboard
  2. Open Settings → Plugins → gear icon → Install Plugin from Disk...
  3. Select the downloaded .zip and restart the IDE

Configure the plugin

After installation, configure your credentials:

  1. Open Settings → Tools → Contox
  2. Enter your API Key, Team ID, and Project ID
  3. Click Verify Connection to confirm the setup

Your credentials are stored in the IDE's secure credential store and never written to project files.

Using Contox with AI Assistant

JetBrains AI Assistant (and tools like Continue.dev) can read context from files in your project. The fastest path is the CLI export:

bash
# Export brain to a file your AI tools can read
contox export -f markdown > .contox/memory.md

If your JetBrains plugin supports a rules or context file (e.g., .junie/guidelines.md for JetBrains Junie), export to that path:

bash
contox export -f markdown > .junie/guidelines.md

Saving sessions from the IDE

Use the Contox tool window (View → Tool Windows → Contox) to save your session directly from the IDE:

  1. Click Save Session
  2. Enter a brief summary of what you worked on
  3. Optionally add structured changes by category

Or use the CLI from the built-in terminal:

bash
contox save "Brief summary of what you accomplished"

Auto-capture via git

The plugin watches your local git repository and automatically captures:

  • Commit messages and changed files
  • Branch switches
  • Session start/end events

No manual action is needed — events are batched and sent in the background.

Fallback: CLI-only setup

If you prefer not to install the plugin, the CLI works standalone in any JetBrains terminal:

bash
# Load project memory at session start
contox memory

# Save at session end
contox save "What you did"

Next steps