Claudix for JetBrains

English | 简体中文

Run Claudix AI Assistant in JetBrains IDEs

Claudix for JetBrains brings the powerful Claudix AI coding assistant to JetBrains IDEs (IntelliJ IDEA, WebStorm, PyCharm, etc.), enabling seamless AI-powered development within your favorite IDE.

📸 Screenshot

🚀 Core Features

• AI-Powered Coding: Intelligent code generation, refactoring, and assistance powered by Claude
• Native JetBrains Integration: Seamlessly integrated into JetBrains IDE workflow
• WebView Chat Interface: Interactive chat interface for natural language interactions

🔧 Supported IDEs

Claudix currently supports the following JetBrains IDE series:

• IntelliJ IDEA (Ultimate & Community)
• WebStorm - JavaScript and TypeScript development
• PyCharm (Professional & Community) - Python development
• PhpStorm - PHP development
• RubyMine - Ruby development
• CLion - C/C++ development
• GoLand - Go development
• DataGrip - Database development
• Rider - .NET development
• Android Studio - Android development

Note: Requires JetBrains IDE version 2023.1 or later for optimal compatibility.

🏗️ Architecture

graph TB
    subgraph "JetBrains IDE"
        A[JetBrains Plugin<br/>Kotlin]
        B[UI Integration]
        C[Editor Bridge]
    end

    subgraph "Extension Host"
        D[Node.js Runtime]
        E[VSCode API Layer]
        F[Extension Manager]
    end

    subgraph "Claudix Extension"
        G[Claudix AI Assistant]
    end

    A <-->|RPC Communication| D
    B --> A
    C --> A

    E --> D
    F --> D

    G --> E

Loading

Architecture Components:

• JetBrains Plugin: Kotlin-based IDE plugin for JetBrains IDE integration
• Extension Host: Node.js runtime environment providing VSCode API compatibility layer
• RPC Communication: High-performance inter-process communication for real-time data exchange
• Claudix Extension: AI-powered coding assistant with WebView chat interface

📦 Installation

Build from Source

Prerequisites

• Node.js 18.0+
• JetBrains IDE 2023.1+
• Git
• JDK 17+
• pnpm

Build Steps

# 1. Clone the repository
git clone https://github.com/haleclipse/Claudix-JetBrains.git
cd Claudix-JetBrains

# 2. Setup development environment
./scripts/setup.sh

# 3. Build the project
./scripts/build.sh

# 4. Install plugin
# Plugin file located at: jetbrains_plugin/build/distributions/
# In IDE: Settings → Plugins → Install Plugin from Disk

Development Mode

# Start extension host in development mode
cd extension_host
npm install
npm run dev

# Run JetBrains plugin in development mode
cd jetbrains_plugin
./gradlew runIde

👥 Developer Information

Project Structure

Claudix-JetBrains/
├── deps/
│   ├── claudix/             # Claudix VSCode extension submodule
│   ├── vscode/              # VSCode source (for Extension Host)
│   └── patches/             # Patches for VSCode Extension Host
├── extension_host/          # Node.js Extension Host
│   ├── src/                 # TypeScript source code
│   └── vscode/              # Patched VSCode API layer
├── jetbrains_plugin/        # JetBrains Plugin
│   ├── src/main/kotlin/     # Kotlin source code
│   │   └── org/haleclipse/claudix/
│   │       ├── core/        # Core plugin functionality
│   │       ├── actions/     # IDE actions and commands
│   │       ├── editor/      # Editor integration
│   │       ├── extensions/  # Extension management
│   │       └── webview/     # WebView support
│   └── build.gradle.kts     # Gradle build configuration
└── scripts/                 # Build and utility scripts

Technology Stack

• Extension Host: Node.js 18+, TypeScript 5.0+
• JetBrains Plugin: Kotlin 1.8+, IntelliJ Platform 2023.1+
• Communication: RPC over Unix Domain Sockets/Named Pipes
• Build Tools: npm/pnpm, Gradle, Shell scripts

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/your-feature
3. Make your changes and add tests
4. Run tests: ./scripts/test.sh
5. Submit a pull request

👥 Contributors

Based on the original RunVSAgent project.

Original Project Contributors

• Naituw - Project Architect
• wayu002
• joker535
• andrewzq777
• debugmm
• Micro66
• qdaxb
• junbaor
• aheizi
• Adam Hill

License

This project is licensed under the Apache License 2.0. See LICENSE for details.

🙏 Acknowledgments

This project is based on RunVSAgent - an innovative cross-platform development tool created by the WeCode-AI Team at Weibo Inc. We sincerely thank the original contributors for their excellent work that made this project possible.

Maintainer

• Author: haleclipse
• Contact: GitHub Issues

---

Star History

Made with ❤️ for the JetBrains community