How npci/ainxt-code works
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: ChatWebviewProvider.ts VS Code panel · SessionManager.ts Session manager · ConnectionManager.ts ACP connection · AcpClientImpl.ts ACP client
Components 24
IDE experience
- VS Code panel
vscode-acp/src/ui/ChatWebviewProvider.ts - Chat interface
vscode-acp/webview-ui/src/App.tsx - Session navigation
vscode-acp/src/ui/SessionTreeProvider.ts - Connection status
vscode-acp/src/ui/StatusBarManager.ts - IntelliJ tool window
hosts/intellij/src/main/kotlin/dev/ainxt/ide/AinxtToolWindowFactory.kt
Agent runtime
- IntelliJ ACP client
hosts/intellij/src/main/kotlin/dev/ainxt/ide/AcpClient.kt - Session manager
vscode-acp/src/core/SessionManager.ts - Agent process manager
vscode-acp/src/core/AgentManager.ts - ACP connection
vscode-acp/src/core/ConnectionManager.ts - ACP client
vscode-acp/src/core/AcpClientImpl.ts - Session update router
vscode-acp/src/handlers/SessionUpdateHandler.ts - Session history
vscode-acp/src/core/SessionHistoryStore.ts
Workspace capabilities
- File access
vscode-acp/src/handlers/FileSystemHandler.ts - Terminal execution
vscode-acp/src/handlers/TerminalHandler.ts - Permission handling
vscode-acp/src/handlers/PermissionHandler.ts
Configuration and governance
- Workspace guard
vscode-acp/src/utils/WorkspaceGuard.ts - Agent configuration
vscode-acp/src/config/AgentConfig.ts - Profile loading
vscode-acp/src/config/ProfileLoader.ts - Agent registry
vscode-acp/src/config/RegistryClient.ts - Gateway security
vscode-acp/src/utils/GatewaySecurity.ts - Telemetry
vscode-acp/src/utils/TelemetryManager.ts - Logging
vscode-acp/src/utils/Logger.ts
Other components
- Developer
- Model provider
Connections 34
- Developer → VS Code panel: opens panel
README.md - Developer → IntelliJ tool window: opens panel
README.md - Developer → Chat interface: sends prompt
vscode-acp/webview-ui/src/App.tsx - Chat interface → VS Code panel: posts messages
vscode-acp/webview-ui/src/App.tsx - VS Code panel → Session manager: manages sessions
vscode-acp/src/extension.ts - VS Code panel → Session navigation: registers provider
vscode-acp/src/extension.ts - VS Code panel → Connection status: registers status
vscode-acp/src/extension.ts - Session navigation → Session manager: reads sessions
vscode-acp/src/ui/SessionTreeProvider.ts - Connection status → Session manager: observes status
vscode-acp/src/ui/StatusBarManager.ts - Session manager → Agent process manager: starts agents
vscode-acp/src/core/SessionManager.ts - Session manager → ACP connection: connects agent
vscode-acp/src/core/SessionManager.ts - Session manager → Session history: resumes sessions
vscode-acp/src/core/SessionManager.ts - ACP connection → ACP client: creates client
vscode-acp/src/core/ConnectionManager.ts - ACP connection → File access: registers handler
vscode-acp/src/core/ConnectionManager.ts - ACP connection → Terminal execution: registers handler
vscode-acp/src/core/ConnectionManager.ts - ACP connection → Permission handling: registers handler
vscode-acp/src/core/ConnectionManager.ts - ACP client → File access: delegates file calls
vscode-acp/src/core/AcpClientImpl.ts - ACP client → Terminal execution: delegates terminal calls
vscode-acp/src/core/AcpClientImpl.ts - ACP client → Permission handling: delegates requests
vscode-acp/src/core/AcpClientImpl.ts - ACP client → Session update router: routes updates
vscode-acp/src/core/AcpClientImpl.ts - Session update router → VS Code panel: notifies listeners
vscode-acp/src/handlers/SessionUpdateHandler.ts - File access → Workspace guard: checks file access
vscode-acp/src/handlers/FileSystemHandler.ts - Terminal execution → Workspace guard: checks command approval
vscode-acp/src/handlers/TerminalHandler.ts - IntelliJ tool window → IntelliJ ACP client: uses ACP client
hosts/intellij/src/main/kotlin/dev/ainxt/ide/AinxtToolWindowFactory.kt - IntelliJ tool window → Agent configuration: reads settings
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
vscode-acp/src/extension.ts - VS Code panel → Agent registry: loads registry
vscode-acp/src/extension.ts - Developer → Model provider: configures model
README.md - Model provider → Agent configuration: provides endpoint settings
README.md - Agent process manager → Telemetry: reports events
vscode-acp/src/core/AgentManager.ts - Agent configuration → Gateway security: checks gateway
vscode-acp/src/config/AgentConfig.ts - Agent process manager → Logging: logs lifecycle
vscode-acp/src/core/AgentManager.ts