Skip to content

overview.md

Latest commit

 

History

History
113 lines (85 loc) · 4.44 KB

overview.md

File metadata and controls

113 lines (85 loc) · 4.44 KB
Raw

ainxt-code Repository Overview

Purpose

ainxt-code is the repository for the AiNxt IDE plugins. It brings the AiNxt coding assistant into popular editors by embedding a shared React chat UI, spawning a local ainxt agent process, and bridging the Agent Client Protocol (ACP) to each IDE's native APIs.

The repository contains two host implementations:

  • vscode_acp — A full-featured VS Code extension that implements ACP client logic, session management, agent spawning, file/terminal handlers, and a rich webview UI directly inside the extension.
  • intellij_host — A JetBrains IDE plugin written in Kotlin/JVM that hosts the same shared React UI inside a JCEF browser and provides a Kotlin bridge to the AiNxt agent.

All hosts share the same React web UI and a common postMessage/ACP contract, so the assistant behaves consistently across VS Code and IntelliJ-based products.

End-to-End Architecture

Repository Layout

flowchart TB
    subgraph IDEs
        VS[VS Code]
        IJ[IntelliJ IDEA / PyCharm / WebStorm]
    end

    subgraph ainxt-code
        VSCP[vscode_acp<br/>Full VS Code ACP host]
        IJH[intellij_host<br/>JetBrains plugin]
        SharedUI[Shared React Web UI]
    end

    subgraph Runtime
        Agent[ainxt agent CLI<br/>ACP over stdio]
        Gateway[AiNxt Gateway]
    end

    VS --> VSCP
    IJ --> IJH

    VSCP --> SharedUI
    IJH --> SharedUI

    VSCP -->|ACP JSON-RPC| Agent
    IJH -->|ACP JSON-RPC| Agent

    Agent -->|auth / budget / model APIs| Gateway
Loading

Typical Prompt Flow

sequenceDiagram
    participant UI as Shared React Web UI
    participant Host as IDE Host<br/>(vscode_acp / intellij_host)
    participant SM as Session Manager / Bridge
    participant Agent as ainxt agent

    UI->>Host: sendPrompt(text)
    Host->>SM: prompt(sessionId, text)
    SM->>Agent: session/prompt

    loop Agent streams updates
        Agent-->>SM: session/update
        SM-->>Host: notify
        Host-->>UI: render update
    end

    Agent-->>SM: prompt result / usage
    SM-->>Host: promptEnd
    Host-->>UI: final state
Loading

Tool Request Flow

sequenceDiagram
    participant Agent as ainxt agent
    participant ACP as ACP Client / Bridge
    participant Host as IDE Host
    participant UI as Shared React Web UI
    participant API as VS Code / IntelliJ API

    Agent->>ACP: tool request<br/>(fs/read, terminal, permission)
    ACP->>Host: delegate request

    alt permission / question / plan approval
        Host->>UI: interactive request
        UI-->>Host: user response
    else file / terminal / IDE action
        Host->>API: native IDE call
        API-->>Host: result
    end

    Host-->>ACP: response
    ACP-->>Agent: ACP response
Loading

Core Modules

Module Path Description Documentation
intellij_host hosts/intellij JetBrains plugin that embeds the shared React UI in a JCEF browser and bridges ACP to Kotlin/IntelliJ APIs. intellij_host.md
vscode_acp vscode-acp Full-featured VS Code ACP host with built-in agent management, session orchestration, handlers, and webview UI. vscode_acp.md
vscode_acp/agent_management vscode-acp/src/core Spawns agents, implements the ACP client, and manages per-turn checkpoints. agent_management.md
vscode_acp/session_management vscode-acp/src/core Manages ACP connections, sessions, resume/load, auth, and history. session_management.md
vscode_acp/handlers vscode-acp/src/handlers Bridges ACP tool requests to VS Code file system, terminal, permission, and session-update APIs. handlers.md
vscode_acp/extension_ui vscode-acp/src/ui, vscode-acp/src/extension.ts VS Code activation, chat webview provider, session tree, status bar, and interactive bridges. extension_ui.md
vscode_acp/webview_ui vscode-acp/webview-ui React front-end bundle shared across VS Code and JetBrains hosts. webview_ui.md
vscode_acp/config vscode-acp/src/config Agent configuration, registry fetching, and secret injection. config.md
vscode_acp/utils vscode-acp/src/utils Logging, telemetry, and stream adapters. utils.md