# rezaldy/split-mode-assistant architecture

> Architecture diagram of the GitHub repository rezaldy/split-mode-assistant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rezaldy/split-mode-assistant
- Repository: https://github.com/rezaldy/split-mode-assistant

## Overview

Split Mode Assistant is a split-mode JetBrains plugin for local/self-hosted AI assistance. The principal workflow runs from the IDE chat UI through the shared RPC contract to a host-side conversation, which assembles project context and streams a model response back to the client. Separate branches cover file attachment search, opt-in indexing, skill activation, code edits, and commit-message generation. The README documents these capabilities; sampled excerpts confirm selected backend service behavior, but not every RPC dispatch or frontend wiring detail, so uncertain links are omitted.

Main entry points: [`backend/src/main/kotlin/com/rizkybusiness/ai/assistant/ollama/OllamaClientService.kt`](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/ollama/OllamaClientService.kt) (Ollama client), [`backend/src/main/kotlin/com/rizkybusiness/ai/assistant/BackendChatRepositoryModel.kt`](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/BackendChatRepositoryModel.kt) (Conversation service), [`backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/SkillDiscoveryService.kt`](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/SkillDiscoveryService.kt) (Skill discovery), [`backend/src/main/kotlin/com/rizkybusiness/ai/assistant/BackendChatRepositoryRpcApi.kt`](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/BackendChatRepositoryRpcApi.kt) (Backend chat RPC)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["IDE client"]
  node_chatui["Chat tool window<br/>[ChatAppSample.kt]"]
  node_chatvm["Chat view model<br/>[ChatViewModel.kt]"]
  node_frontendrepo["Client chat repository"]
end

subgraph group_rpc["RPC and chat"]
  node_contract["Chat RPC contract"]
  node_backendrpc["Backend chat RPC"]
  node_chat["Conversation service"]
end

subgraph group_project["Project capabilities"]
  node_context["Project context"]
  node_fileapi["File search API"]
  node_index[("Project index")]
  node_retrieval["Context retrieval"]
  node_edit["Code edit API"]
  node_skillsapi["Skills API"]
  node_skills["Skill discovery"]
  node_parser["Skill manifest parser"]
end

subgraph group_models["Models and tools"]
  node_modelsapi["Models API"]
  node_ollama["Ollama client"]
  node_commitaction["Commit action"]
  node_commit["Commit generator"]
  node_settings["Assistant settings"]
end

node_user(("IDE user"))
node_modelservice(("Ollama endpoint"))

node_user -->|"asks question"| node_chatui
node_chatui -->|"submits input"| node_chatvm
node_chatvm -->|"manages chat"| node_frontendrepo
node_frontendrepo -->|"calls RPC"| node_contract
node_backendrpc -->|"implements"| node_contract
node_backendrpc -->|"dispatches"| node_chat
node_chat -->|"collects context"| node_context
node_chat -->|"resolves model"| node_modelsapi
node_chat -->|"streams generation"| node_ollama
node_ollama -->|"sends requests"| node_modelservice
node_modelservice -->|"returns tokens"| node_ollama
node_chat -->|"reads skill bodies"| node_skills
node_skillsapi -->|"discovers skills"| node_skills
node_skills -->|"parses manifests"| node_parser
node_index -->|"embeds chunks"| node_ollama
node_chat -.->|"retrieves context"| node_retrieval
node_user -->|"requests message"| node_commitaction
node_commitaction -->|"starts generation"| node_commit
node_commit -->|"streams completion"| node_ollama
node_modelsapi -->|"lists models"| node_ollama
node_settings -->|"configures endpoint"| node_ollama

click node_chatui "https://github.com/rezaldy/split-mode-assistant/blob/main/frontend/src/main/kotlin/com/rizkybusiness/ai/assistant/chatApp/ChatAppSample.kt"
click node_chatvm "https://github.com/rezaldy/split-mode-assistant/blob/main/frontend/src/main/kotlin/com/rizkybusiness/ai/assistant/chatApp/viewmodel/ChatViewModel.kt"
click node_frontendrepo "https://github.com/rezaldy/split-mode-assistant/blob/main/frontend/src/main/kotlin/com/rizkybusiness/ai/assistant/chatApp/viewmodel/FrontendChatRepositoryModel.kt"
click node_contract "https://github.com/rezaldy/split-mode-assistant/blob/main/shared/src/main/kotlin/com/rizkybusiness/ai/assistant/ChatRepositoryRpcApi.kt"
click node_backendrpc "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/BackendChatRepositoryRpcApi.kt"
click node_chat "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/BackendChatRepositoryModel.kt"
click node_context "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/context/ProjectContextCollector.kt"
click node_fileapi "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/search/FileSearchService.kt"
click node_index "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/index/ProjectIndexService.kt"
click node_retrieval "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/index/RetrievalSelector.kt"
click node_edit "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/edit/BackendCodeEditApi.kt"
click node_skillsapi "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/BackendSkillsApi.kt"
click node_skills "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/SkillDiscoveryService.kt"
click node_parser "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/SkillManifestParser.kt"
click node_modelsapi "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/models/BackendModelsService.kt"
click node_ollama "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/ollama/OllamaClientService.kt"
click node_commitaction "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/commit/GenerateCommitMessageAction.kt"
click node_commit "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/commit/CommitMessageGeneratorService.kt"
click node_settings "https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/settings/AssistantSettings.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_chatui,node_chatvm,node_frontendrepo,node_user toneBlue
class node_contract,node_backendrpc,node_chat toneAmber
class node_context,node_fileapi,node_index,node_retrieval,node_edit,node_skillsapi,node_skills,node_parser toneMint
class node_modelsapi,node_ollama,node_commitaction,node_commit,node_settings toneRose
class node_modelservice toneIndigo
```

## Components

### IDE client

- [Chat tool window](https://github.com/rezaldy/split-mode-assistant/blob/main/frontend/src/main/kotlin/com/rizkybusiness/ai/assistant/chatApp/ChatAppSample.kt): `frontend/src/main/kotlin/com/rizkybusiness/ai/assistant/chatApp/ChatAppSample.kt`
- [Chat view model](https://github.com/rezaldy/split-mode-assistant/blob/main/frontend/src/main/kotlin/com/rizkybusiness/ai/assistant/chatApp/viewmodel/ChatViewModel.kt): `frontend/src/main/kotlin/com/rizkybusiness/ai/assistant/chatApp/viewmodel/ChatViewModel.kt`
- [Client chat repository](https://github.com/rezaldy/split-mode-assistant/blob/main/frontend/src/main/kotlin/com/rizkybusiness/ai/assistant/chatApp/viewmodel/FrontendChatRepositoryModel.kt): `frontend/src/main/kotlin/com/rizkybusiness/ai/assistant/chatApp/viewmodel/FrontendChatRepositoryModel.kt`

### RPC and chat

- [Chat RPC contract](https://github.com/rezaldy/split-mode-assistant/blob/main/shared/src/main/kotlin/com/rizkybusiness/ai/assistant/ChatRepositoryRpcApi.kt): `shared/src/main/kotlin/com/rizkybusiness/ai/assistant/ChatRepositoryRpcApi.kt`
- [Backend chat RPC](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/BackendChatRepositoryRpcApi.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/BackendChatRepositoryRpcApi.kt`
- [Conversation service](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/BackendChatRepositoryModel.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/BackendChatRepositoryModel.kt`

### Project capabilities

- [Project context](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/context/ProjectContextCollector.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/context/ProjectContextCollector.kt`
- [File search API](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/search/FileSearchService.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/search/FileSearchService.kt`
- [Project index](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/index/ProjectIndexService.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/index/ProjectIndexService.kt`
- [Context retrieval](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/index/RetrievalSelector.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/index/RetrievalSelector.kt`
- [Code edit API](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/edit/BackendCodeEditApi.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/edit/BackendCodeEditApi.kt`
- [Skills API](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/BackendSkillsApi.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/BackendSkillsApi.kt`
- [Skill discovery](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/SkillDiscoveryService.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/SkillDiscoveryService.kt`
- [Skill manifest parser](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/SkillManifestParser.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/skills/SkillManifestParser.kt`

### Models and tools

- [Models API](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/models/BackendModelsService.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/models/BackendModelsService.kt`
- [Ollama client](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/ollama/OllamaClientService.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/ollama/OllamaClientService.kt`
- [Commit action](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/commit/GenerateCommitMessageAction.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/commit/GenerateCommitMessageAction.kt`
- [Commit generator](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/commit/CommitMessageGeneratorService.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/commit/CommitMessageGeneratorService.kt`
- [Assistant settings](https://github.com/rezaldy/split-mode-assistant/blob/main/backend/src/main/kotlin/com/rizkybusiness/ai/assistant/settings/AssistantSettings.kt): `backend/src/main/kotlin/com/rizkybusiness/ai/assistant/settings/AssistantSettings.kt`

### Other components

- **IDE user**
- **Ollama endpoint**

## Connections

- IDE user → Chat tool window: asks question
- Chat tool window → Chat view model: submits input
- Chat view model → Client chat repository: manages chat
- Client chat repository → Chat RPC contract: calls RPC
- Backend chat RPC → Chat RPC contract: implements
- Backend chat RPC → Conversation service: dispatches
- Conversation service → Project context: collects context
- Conversation service → Models API: resolves model
- Conversation service → Ollama client: streams generation
- Ollama client → Ollama endpoint: sends requests
- Ollama endpoint → Ollama client: returns tokens
- Conversation service → Skill discovery: reads skill bodies
- Skills API → Skill discovery: discovers skills
- Skill discovery → Skill manifest parser: parses manifests
- Project index → Ollama client: embeds chunks
- Conversation service → Context retrieval: retrieves context
- IDE user → Commit action: requests message
- Commit action → Commit generator: starts generation
- Commit generator → Ollama client: streams completion
- Models API → Ollama client: lists models
- Assistant settings → Ollama client: configures endpoint
