# npci/ainxt-code architecture

> Architecture diagram of the GitHub repository npci/ainxt-code, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/npci/ainxt-code
- Repository: https://github.com/npci/ainxt-code

## Overview

AiNxt Code provides an AI coding agent inside VS Code and IntelliJ. The main workflow is: a developer opens the IDE panel, configures or selects an agent/model, sends a prompt, and receives session updates and results; the ACP runtime can also request workspace file access, terminal execution, or user permission. The graph emphasizes the better-evidenced VS Code runtime and includes IntelliJ’s documented panel path. README capability claims cover model/provider choice; unsampled internals and some cross-IDE wiring are not inferred.

Main entry points: [`vscode-acp/src/ui/ChatWebviewProvider.ts`](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/ui/ChatWebviewProvider.ts) (VS Code panel), [`vscode-acp/src/core/SessionManager.ts`](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/SessionManager.ts) (Session manager), [`vscode-acp/src/core/ConnectionManager.ts`](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/ConnectionManager.ts) (ACP connection), [`vscode-acp/src/core/AcpClientImpl.ts`](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/AcpClientImpl.ts) (ACP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ide["IDE experience"]
  node_vscode["VS Code panel"]
  node_chatui["Chat interface<br/>[App.tsx]"]
  node_sessionui["Session navigation"]
  node_statusui["Connection status"]
  node_intellij["IntelliJ tool window"]
end

subgraph group_runtime["Agent runtime"]
  node_intellijacp["IntelliJ ACP client<br/>[AcpClient.kt]"]
  node_session["Session manager<br/>[SessionManager.ts]"]
  node_agents["Agent process manager<br/>[AgentManager.ts]"]
  node_connection["ACP connection"]
  node_acpclient["ACP client<br/>[AcpClientImpl.ts]"]
  node_updates["Session update router"]
  node_history[("Session history")]
end

subgraph group_workspace["Workspace capabilities"]
  node_filesystem["File access"]
  node_terminal["Terminal execution<br/>[TerminalHandler.ts]"]
  node_permissions["Permission handling"]
end

subgraph group_governance["Configuration and governance"]
  node_guard["Workspace guard<br/>[WorkspaceGuard.ts]"]
  node_config["Agent configuration<br/>[AgentConfig.ts]"]
  node_profiles["Profile loading<br/>[ProfileLoader.ts]"]
  node_registry["Agent registry<br/>[RegistryClient.ts]"]
  node_security["Gateway security<br/>[GatewaySecurity.ts]"]
  node_telemetry["Telemetry"]
  node_logger["Logging<br/>[Logger.ts]"]
end

node_developer(("Developer"))
node_modelprovider(("Model provider"))

node_developer -->|"opens panel"| node_vscode
node_developer -->|"opens panel"| node_intellij
node_developer -->|"sends prompt"| node_chatui
node_chatui -->|"posts messages"| node_vscode
node_vscode -->|"manages sessions"| node_session
node_vscode -->|"registers provider"| node_sessionui
node_vscode -->|"registers status"| node_statusui
node_sessionui -->|"reads sessions"| node_session
node_statusui -->|"observes status"| node_session
node_session -->|"starts agents"| node_agents
node_session -->|"connects agent"| node_connection
node_session -->|"resumes sessions"| node_history
node_connection -->|"creates client"| node_acpclient
node_connection -->|"registers handler"| node_filesystem
node_connection -->|"registers handler"| node_terminal
node_connection -->|"registers handler"| node_permissions
node_acpclient -->|"delegates file calls"| node_filesystem
node_acpclient -->|"delegates terminal calls"| node_terminal
node_acpclient -->|"delegates requests"| node_permissions
node_acpclient -->|"routes updates"| node_updates
node_updates -->|"notifies listeners"| node_vscode
node_filesystem -->|"checks file access"| node_guard
node_terminal -->|"checks command approval"| node_guard
node_intellij -->|"uses ACP client"| node_intellijacp
node_intellij -->|"reads settings"| node_config
node_intellij -->|"loads profiles"| node_profiles
node_profiles -->|"updates settings"| node_config
node_vscode -->|"loads configuration"| node_config
node_vscode -->|"loads registry"| node_registry
node_developer -->|"configures model"| node_modelprovider
node_modelprovider -.->|"provides endpoint settings"| node_config
node_agents -->|"reports events"| node_telemetry
node_config -->|"checks gateway"| node_security
node_agents -->|"logs lifecycle"| node_logger

click node_vscode "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/ui/ChatWebviewProvider.ts"
click node_chatui "https://github.com/npci/ainxt-code/blob/main/vscode-acp/webview-ui/src/App.tsx"
click node_sessionui "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/ui/SessionTreeProvider.ts"
click node_statusui "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/ui/StatusBarManager.ts"
click node_intellij "https://github.com/npci/ainxt-code/blob/main/hosts/intellij/src/main/kotlin/dev/ainxt/ide/AinxtToolWindowFactory.kt"
click node_intellijacp "https://github.com/npci/ainxt-code/blob/main/hosts/intellij/src/main/kotlin/dev/ainxt/ide/AcpClient.kt"
click node_session "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/SessionManager.ts"
click node_agents "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/AgentManager.ts"
click node_connection "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/ConnectionManager.ts"
click node_acpclient "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/AcpClientImpl.ts"
click node_updates "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/handlers/SessionUpdateHandler.ts"
click node_history "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/SessionHistoryStore.ts"
click node_filesystem "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/handlers/FileSystemHandler.ts"
click node_terminal "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/handlers/TerminalHandler.ts"
click node_permissions "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/handlers/PermissionHandler.ts"
click node_guard "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/utils/WorkspaceGuard.ts"
click node_config "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/config/AgentConfig.ts"
click node_profiles "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/config/ProfileLoader.ts"
click node_registry "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/config/RegistryClient.ts"
click node_security "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/utils/GatewaySecurity.ts"
click node_telemetry "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/utils/TelemetryManager.ts"
click node_logger "https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/utils/Logger.ts"

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_vscode,node_chatui,node_sessionui,node_statusui,node_intellij toneBlue
class node_intellijacp,node_session,node_agents,node_connection,node_acpclient,node_updates,node_history toneAmber
class node_filesystem,node_terminal,node_permissions toneMint
class node_guard,node_config,node_profiles,node_registry,node_security,node_telemetry,node_logger toneRose
class node_developer,node_modelprovider toneIndigo
```

## Components

### IDE experience

- [VS Code panel](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/ui/ChatWebviewProvider.ts): `vscode-acp/src/ui/ChatWebviewProvider.ts`
- [Chat interface](https://github.com/npci/ainxt-code/blob/main/vscode-acp/webview-ui/src/App.tsx): `vscode-acp/webview-ui/src/App.tsx`
- [Session navigation](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/ui/SessionTreeProvider.ts): `vscode-acp/src/ui/SessionTreeProvider.ts`
- [Connection status](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/ui/StatusBarManager.ts): `vscode-acp/src/ui/StatusBarManager.ts`
- [IntelliJ tool window](https://github.com/npci/ainxt-code/blob/main/hosts/intellij/src/main/kotlin/dev/ainxt/ide/AinxtToolWindowFactory.kt): `hosts/intellij/src/main/kotlin/dev/ainxt/ide/AinxtToolWindowFactory.kt`

### Agent runtime

- [IntelliJ ACP client](https://github.com/npci/ainxt-code/blob/main/hosts/intellij/src/main/kotlin/dev/ainxt/ide/AcpClient.kt): `hosts/intellij/src/main/kotlin/dev/ainxt/ide/AcpClient.kt`
- [Session manager](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/SessionManager.ts): `vscode-acp/src/core/SessionManager.ts`
- [Agent process manager](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/AgentManager.ts): `vscode-acp/src/core/AgentManager.ts`
- [ACP connection](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/ConnectionManager.ts): `vscode-acp/src/core/ConnectionManager.ts`
- [ACP client](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/AcpClientImpl.ts): `vscode-acp/src/core/AcpClientImpl.ts`
- [Session update router](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/handlers/SessionUpdateHandler.ts): `vscode-acp/src/handlers/SessionUpdateHandler.ts`
- [Session history](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/core/SessionHistoryStore.ts): `vscode-acp/src/core/SessionHistoryStore.ts`

### Workspace capabilities

- [File access](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/handlers/FileSystemHandler.ts): `vscode-acp/src/handlers/FileSystemHandler.ts`
- [Terminal execution](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/handlers/TerminalHandler.ts): `vscode-acp/src/handlers/TerminalHandler.ts`
- [Permission handling](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/handlers/PermissionHandler.ts): `vscode-acp/src/handlers/PermissionHandler.ts`

### Configuration and governance

- [Workspace guard](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/utils/WorkspaceGuard.ts): `vscode-acp/src/utils/WorkspaceGuard.ts`
- [Agent configuration](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/config/AgentConfig.ts): `vscode-acp/src/config/AgentConfig.ts`
- [Profile loading](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/config/ProfileLoader.ts): `vscode-acp/src/config/ProfileLoader.ts`
- [Agent registry](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/config/RegistryClient.ts): `vscode-acp/src/config/RegistryClient.ts`
- [Gateway security](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/utils/GatewaySecurity.ts): `vscode-acp/src/utils/GatewaySecurity.ts`
- [Telemetry](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/utils/TelemetryManager.ts): `vscode-acp/src/utils/TelemetryManager.ts`
- [Logging](https://github.com/npci/ainxt-code/blob/main/vscode-acp/src/utils/Logger.ts): `vscode-acp/src/utils/Logger.ts`

### Other components

- **Developer**
- **Model provider**

## Connections

- Developer → VS Code panel: opens panel (evidence: `README.md`)
- Developer → IntelliJ tool window: opens panel (evidence: `README.md`)
- Developer → Chat interface: sends prompt (evidence: `vscode-acp/webview-ui/src/App.tsx`)
- Chat interface → VS Code panel: posts messages (evidence: `vscode-acp/webview-ui/src/App.tsx`)
- VS Code panel → Session manager: manages sessions (evidence: `vscode-acp/src/extension.ts`)
- VS Code panel → Session navigation: registers provider (evidence: `vscode-acp/src/extension.ts`)
- VS Code panel → Connection status: registers status (evidence: `vscode-acp/src/extension.ts`)
- Session navigation → Session manager: reads sessions (evidence: `vscode-acp/src/ui/SessionTreeProvider.ts`)
- Connection status → Session manager: observes status (evidence: `vscode-acp/src/ui/StatusBarManager.ts`)
- Session manager → Agent process manager: starts agents (evidence: `vscode-acp/src/core/SessionManager.ts`)
- Session manager → ACP connection: connects agent (evidence: `vscode-acp/src/core/SessionManager.ts`)
- Session manager → Session history: resumes sessions (evidence: `vscode-acp/src/core/SessionManager.ts`)
- ACP connection → ACP client: creates client (evidence: `vscode-acp/src/core/ConnectionManager.ts`)
- ACP connection → File access: registers handler (evidence: `vscode-acp/src/core/ConnectionManager.ts`)
- ACP connection → Terminal execution: registers handler (evidence: `vscode-acp/src/core/ConnectionManager.ts`)
- ACP connection → Permission handling: registers handler (evidence: `vscode-acp/src/core/ConnectionManager.ts`)
- ACP client → File access: delegates file calls (evidence: `vscode-acp/src/core/AcpClientImpl.ts`)
- ACP client → Terminal execution: delegates terminal calls (evidence: `vscode-acp/src/core/AcpClientImpl.ts`)
- ACP client → Permission handling: delegates requests (evidence: `vscode-acp/src/core/AcpClientImpl.ts`)
- ACP client → Session update router: routes updates (evidence: `vscode-acp/src/core/AcpClientImpl.ts`)
- Session update router → VS Code panel: notifies listeners (evidence: `vscode-acp/src/handlers/SessionUpdateHandler.ts`)
- File access → Workspace guard: checks file access (evidence: `vscode-acp/src/handlers/FileSystemHandler.ts`)
- Terminal execution → Workspace guard: checks command approval (evidence: `vscode-acp/src/handlers/TerminalHandler.ts`)
- IntelliJ tool window → IntelliJ ACP client: uses ACP client (evidence: `hosts/intellij/src/main/kotlin/dev/ainxt/ide/AinxtToolWindowFactory.kt`)
- IntelliJ tool window → Agent configuration: reads settings (evidence: `hosts/intellij/src/main/kotlin/dev/ainxt/ide/AinxtToolWindowFactory.kt`)
- IntelliJ tool window → Profile loading: loads profiles
- Profile loading → Agent configuration: updates settings
- VS Code panel → Agent configuration: loads configuration (evidence: `vscode-acp/src/extension.ts`)
- VS Code panel → Agent registry: loads registry (evidence: `vscode-acp/src/extension.ts`)
- Developer → Model provider: configures model (evidence: `README.md`)
- Model provider → Agent configuration: provides endpoint settings (evidence: `README.md`)
- Agent process manager → Telemetry: reports events (evidence: `vscode-acp/src/core/AgentManager.ts`)
- Agent configuration → Gateway security: checks gateway (evidence: `vscode-acp/src/config/AgentConfig.ts`)
- Agent process manager → Logging: logs lifecycle (evidence: `vscode-acp/src/core/AgentManager.ts`)
