Add PyCharm plugin and refactor to use shared db functions

Co-authored-by: Mte90 <403283+Mte90@users.noreply.github.com>

Author: Copilot

README.md

@@ -33,6 +33,18 @@ This tool is a way to achieve this!
 - Semantic search and code completion endpoints
 - See [PYCHARM_INTEGRATION.md](PYCHARM_INTEGRATION.md) for full API documentation
 
+### PyCharm Plugin
+
+A full-featured PyCharm/IntelliJ IDEA plugin is available in the `plugin/` directory:
+
+- **Per-Project Indexing**: Automatically indexes current project
+- **Secure API Keys**: Stores credentials in IDE password safe
+- **Real-time Responses**: Streams answers from your coding model
+- **File Navigation**: Click retrieved files to open in editor
+- **Progress Indicators**: Visual feedback during indexing
+
+See [plugin/README.md](plugin/README.md) for installation and usage instructions.
+
 Prerequisites
 - Python 3.8+ (3.11+ recommended for builtin tomllib)
 - Git (optional, if you clone the repo)

example_client.py

@@ -0,0 +1,102 @@
+# PicoCode PyCharm Plugin
+
+PyCharm/IntelliJ IDEA plugin for PicoCode RAG Assistant with per-project persistent storage.
+
+## Features
+
+- **Per-Project Storage**: Indexes each project into `.local_rag` directory
+- **Secure API Key Storage**: Uses IDE's built-in password safe
+- **Real-time Responses**: Streams responses from the coding model
+- **File Navigation**: Click on retrieved files to open them in the editor
+- **Progress Tracking**: Visual progress indicator during indexing
+
+## Building the Plugin
+
+```bash
+cd plugin
+./gradlew buildPlugin
+```
+
+The plugin ZIP will be in `build/distributions/`.
+
+## Installation
+
+1. Build the plugin or download from releases
+2. In PyCharm/IntelliJ IDEA: `Settings` → `Plugins` → `⚙️` → `Install Plugin from Disk`
+3. Select the plugin ZIP file
+4. Restart IDE
+
+## Usage
+
+1. Open the PicoCode RAG tool window (right sidebar)
+2. Configure your OpenAI-compatible API:
+   - API Base URL (e.g., `https://api.openai.com/v1`)
+   - API Key (stored securely in IDE password safe)
+   - Embedding Model (e.g., `text-embedding-3-small`)
+   - Coding Model (e.g., `gpt-4`)
+3. Click "Save API Key" to store it securely
+4. Click "Start Server" to launch the Python backend
+5. Click "Index Project" to index your current project
+6. Ask questions in the query box and click "Query"
+
+## Requirements
+
+- PyCharm/IntelliJ IDEA 2023.1 or later
+- Python 3.8+ installed and in PATH
+- PicoCode backend dependencies installed (`pip install -r pyproject.toml`)
+
+## Project Structure
+
+```
+plugin/
+├── build.gradle.kts           # Gradle build configuration
+└── src/
+    └── main/
+        ├── kotlin/
+        │   └── com/picocode/
+        │       ├── PicoCodeToolWindowFactory.kt    # Tool window factory
+        │       └── PicoCodeToolWindowContent.kt    # Main UI and logic
+        └── resources/
+            └── META-INF/
+                └── plugin.xml                       # Plugin descriptor
+```
+
+## Architecture
+
+1. **Server Management**: Plugin starts Python server as subprocess in project directory
+2. **API Communication**: HTTP REST API for project management and queries
+3. **Secure Storage**: API keys stored using IntelliJ's `PasswordSafe` API
+4. **File Navigation**: Uses IntelliJ's Open API to navigate to retrieved files
+
+## API Endpoints Used
+
+- `POST /api/projects` - Create/get project
+- `POST /api/projects/index` - Start indexing
+- `POST /api/code` - Query with RAG context
+- `GET /api/projects` - List projects
+
+## Development
+
+To modify the plugin:
+
+1. Open `plugin/` in IntelliJ IDEA
+2. Make changes to Kotlin files
+3. Run `./gradlew runIde` to test in a sandbox IDE
+4. Build with `./gradlew buildPlugin`
+
+## Troubleshooting
+
+**Server won't start**
+- Check Python is in PATH
+- Verify PicoCode dependencies are installed
+- Check console for error messages
+
+**Indexing fails**
+- Ensure project path is accessible
+- Check API key is configured correctly
+- Verify API base URL is reachable
+
+**No query results**
+- Index the project first
+- Check server is running
+- Verify embeddings model is correct

plugin/README.md

@@ -0,0 +1,49 @@
+plugins {
+    id("java")
+    id("org.jetbrains.kotlin.jvm") version "1.9.0"
+    id("org.jetbrains.intellij") version "1.15.0"
+}
+
+group = "com.picocode"
+version = "0.2.0"
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    implementation("com.google.code.gson:gson:2.10.1")
+    implementation("org.java-websocket:Java-WebSocket:1.5.3")
+}
+
+intellij {
+    version.set("2023.1")
+    type.set("IC") // IntelliJ IDEA Community Edition
+    plugins.set(listOf())
+}
+
+tasks {
+    withType<JavaCompile> {
+        sourceCompatibility = "17"
+        targetCompatibility = "17"
+    }
+    
+    withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile> {
+        kotlinOptions.jvmTarget = "17"
+    }
+
+    patchPluginXml {
+        sinceBuild.set("231")
+        untilBuild.set("241.*")
+    }
+
+    signPlugin {
+        certificateChain.set(System.getenv("CERTIFICATE_CHAIN"))
+        privateKey.set(System.getenv("PRIVATE_KEY"))
+        password.set(System.getenv("PRIVATE_KEY_PASSWORD"))
+    }
+
+    publishPlugin {
+        token.set(System.getenv("PUBLISH_TOKEN"))
+    }
+}