# jun516/qwen-code architecture

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

- Interactive diagram: https://gitdiagram.com/jun516/qwen-code
- Repository: https://github.com/jun516/qwen-code

## Overview

Qwen Code is an AI coding agent offered through terminal, desktop, web, editor, chat, and SDK interfaces. The documented primary workflow is to start it in a project, configure a model provider, submit a coding or repository task, and receive an agent response. README capabilities also include memory, skills, subagents, teams, MCP, hooks, and plan mode. The graph preserves those product surfaces and major runtime areas; several internal connections are omitted because the available excerpts do not establish their callers or routing.

Main entry points: [`packages/core/src/services/session-execution-engine.ts`](https://github.com/jun516/qwen-code/blob/main/packages/core/src/services/session-execution-engine.ts) (Session Engine), [`packages/managed-agent-server/src/main/java/com/alibaba/qwen/code/managedagent/service/ManagedAgentService.java`](https://github.com/jun516/qwen-code/blob/main/packages/managed-agent-server/src/main/java/com/alibaba/qwen/code/managedagent/service/ManagedAgentService.java) (Managed Sessions), [`packages/cli/index.ts`](https://github.com/jun516/qwen-code/blob/main/packages/cli/index.ts) (Terminal CLI), [`packages/channels/base/src/ChannelBase.ts`](https://github.com/jun516/qwen-code/blob/main/packages/channels/base/src/ChannelBase.ts) (Chat Channels)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_terminal["Terminal CLI<br/>[index.ts]"]
  node_desktop["Desktop App<br/>[main.rs]"]
  node_web["Web UI"]
  node_editor["VS Code Companion"]
  node_chat["Chat Channels<br/>[ChannelBase.ts]"]
  node_sdk["SDK Clients<br/>[Query.ts]"]
  node_history["Session History UI"]
end

subgraph group_agent["Agent Runtime"]
  node_session["Session Engine"]
  node_llm["Model Generation<br/>[baseLlmClient.ts]"]
  node_compaction["Transcript Compaction"]
  node_memory["Auto Memory<br/>[auto-recall.ts]"]
  node_skills["Skills"]
end

subgraph group_services["Runtime Services"]
  node_daemon["ACP Daemon<br/>[bridge.ts]"]
  node_managed["Managed Sessions"]
  node_broker["Runtime Broker"]
  node_sessionlog[("Managed Session Log")]
  node_channels["Channel Routing<br/>[SessionRouter.ts]"]
end

subgraph group_integrations["Integrations"]
  node_mcp["MCP Integration"]
  node_browser["Browser Use<br/>[engine.rs]"]
  node_live["Live Audio<br/>[audio-engine.ts]"]
  node_memoryprovider["Memory Provider<br/>[request-engine.ts]"]
end

node_user(("User"))
node_external(("Model Provider"))

node_user -->|"starts in project"| node_terminal
node_user -->|"uses"| node_desktop
node_user -->|"opens"| node_web
node_user -->|"integrates with"| node_editor
node_user -->|"connects through"| node_chat
node_user -->|"automates with"| node_sdk
node_user -->|"starts with qwen serve"| node_daemon
node_user -->|"configures provider"| node_external
node_terminal -.->|"runs coding tasks"| node_session
node_daemon -.->|"serves sessions"| node_session
node_session -.->|"generates responses"| node_llm
node_session -.->|"uses memory"| node_memory
node_session -.->|"uses skills"| node_skills
node_session -.->|"connects tools"| node_mcp
node_session -.->|"uses browser tools"| node_browser
node_session -.->|"supports live mode"| node_live
node_session -.->|"compacts replay"| node_compaction
node_managed -->|"dispatches lifecycle"| node_broker
node_managed -.->|"records session state"| node_sessionlog
node_chat -.->|"routes messages"| node_channels
node_memory -.->|"queries provider"| node_memoryprovider

click node_terminal "https://github.com/jun516/qwen-code/blob/main/packages/cli/index.ts"
click node_desktop "https://github.com/jun516/qwen-code/blob/main/packages/desktop/src-tauri/src/main.rs"
click node_web "https://github.com/jun516/qwen-code/tree/main/packages/web-shell/client"
click node_editor "https://github.com/jun516/qwen-code/blob/main/packages/vscode-ide-companion/src/services/qwenAgentManager.ts"
click node_chat "https://github.com/jun516/qwen-code/blob/main/packages/channels/base/src/ChannelBase.ts"
click node_sdk "https://github.com/jun516/qwen-code/blob/main/packages/sdk-typescript/src/query/Query.ts"
click node_daemon "https://github.com/jun516/qwen-code/blob/main/packages/acp-bridge/src/bridge.ts"
click node_session "https://github.com/jun516/qwen-code/blob/main/packages/core/src/services/session-execution-engine.ts"
click node_llm "https://github.com/jun516/qwen-code/blob/main/packages/core/src/core/baseLlmClient.ts"
click node_compaction "https://github.com/jun516/qwen-code/blob/main/packages/acp-bridge/src/compactionEngine.ts"
click node_history "https://github.com/jun516/qwen-code/blob/main/packages/cli/src/ui/hooks/useHistoryManager.ts"
click node_memory "https://github.com/jun516/qwen-code/blob/main/integrations/external-context/src/auto-recall.ts"
click node_skills "https://github.com/jun516/qwen-code/blob/main/packages/cli/src/acp-integration/extension-skills.ts"
click node_managed "https://github.com/jun516/qwen-code/blob/main/packages/managed-agent-server/src/main/java/com/alibaba/qwen/code/managedagent/service/ManagedAgentService.java"
click node_broker "https://github.com/jun516/qwen-code/blob/main/packages/managed-agent-server/src/main/java/com/alibaba/qwen/code/runtimebroker/RuntimeBrokerService.java"
click node_sessionlog "https://github.com/jun516/qwen-code/blob/main/packages/core/src/managed-runtime/managed-session-storage.ts"
click node_channels "https://github.com/jun516/qwen-code/blob/main/packages/channels/base/src/SessionRouter.ts"
click node_mcp "https://github.com/jun516/qwen-code/blob/main/packages/core/src/mcp/oauth-token-storage.ts"
click node_browser "https://github.com/jun516/qwen-code/blob/main/packages/cua-driver/rust/crates/cua-driver-core/src/browser/engine.rs"
click node_live "https://github.com/jun516/qwen-code/blob/main/packages/live-host/src/preload/audio-engine.ts"
click node_memoryprovider "https://github.com/jun516/qwen-code/blob/main/integrations/external-context-mem0/src/request-engine.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_terminal,node_desktop,node_web,node_editor,node_chat,node_sdk,node_history,node_user toneBlue
class node_session,node_llm,node_compaction,node_memory,node_skills toneAmber
class node_daemon,node_managed,node_broker,node_sessionlog,node_channels toneMint
class node_mcp,node_browser,node_live,node_memoryprovider toneRose
class node_external toneIndigo
```

## Components

### User Interfaces

- [Terminal CLI](https://github.com/jun516/qwen-code/blob/main/packages/cli/index.ts): `packages/cli/index.ts`
- [Desktop App](https://github.com/jun516/qwen-code/blob/main/packages/desktop/src-tauri/src/main.rs): `packages/desktop/src-tauri/src/main.rs`
- [Web UI](https://github.com/jun516/qwen-code/tree/main/packages/web-shell/client): `packages/web-shell/client`
- [VS Code Companion](https://github.com/jun516/qwen-code/blob/main/packages/vscode-ide-companion/src/services/qwenAgentManager.ts): `packages/vscode-ide-companion/src/services/qwenAgentManager.ts`
- [Chat Channels](https://github.com/jun516/qwen-code/blob/main/packages/channels/base/src/ChannelBase.ts): `packages/channels/base/src/ChannelBase.ts`
- [SDK Clients](https://github.com/jun516/qwen-code/blob/main/packages/sdk-typescript/src/query/Query.ts): `packages/sdk-typescript/src/query/Query.ts`
- [Session History UI](https://github.com/jun516/qwen-code/blob/main/packages/cli/src/ui/hooks/useHistoryManager.ts): `packages/cli/src/ui/hooks/useHistoryManager.ts`

### Agent Runtime

- [Session Engine](https://github.com/jun516/qwen-code/blob/main/packages/core/src/services/session-execution-engine.ts): `packages/core/src/services/session-execution-engine.ts`
- [Model Generation](https://github.com/jun516/qwen-code/blob/main/packages/core/src/core/baseLlmClient.ts): `packages/core/src/core/baseLlmClient.ts`
- [Transcript Compaction](https://github.com/jun516/qwen-code/blob/main/packages/acp-bridge/src/compactionEngine.ts): `packages/acp-bridge/src/compactionEngine.ts`
- [Auto Memory](https://github.com/jun516/qwen-code/blob/main/integrations/external-context/src/auto-recall.ts): `integrations/external-context/src/auto-recall.ts`
- [Skills](https://github.com/jun516/qwen-code/blob/main/packages/cli/src/acp-integration/extension-skills.ts): `packages/cli/src/acp-integration/extension-skills.ts`

### Runtime Services

- [ACP Daemon](https://github.com/jun516/qwen-code/blob/main/packages/acp-bridge/src/bridge.ts): `packages/acp-bridge/src/bridge.ts`
- [Managed Sessions](https://github.com/jun516/qwen-code/blob/main/packages/managed-agent-server/src/main/java/com/alibaba/qwen/code/managedagent/service/ManagedAgentService.java): `packages/managed-agent-server/src/main/java/com/alibaba/qwen/code/managedagent/service/ManagedAgentService.java`
- [Runtime Broker](https://github.com/jun516/qwen-code/blob/main/packages/managed-agent-server/src/main/java/com/alibaba/qwen/code/runtimebroker/RuntimeBrokerService.java): `packages/managed-agent-server/src/main/java/com/alibaba/qwen/code/runtimebroker/RuntimeBrokerService.java`
- [Managed Session Log](https://github.com/jun516/qwen-code/blob/main/packages/core/src/managed-runtime/managed-session-storage.ts): `packages/core/src/managed-runtime/managed-session-storage.ts`
- [Channel Routing](https://github.com/jun516/qwen-code/blob/main/packages/channels/base/src/SessionRouter.ts): `packages/channels/base/src/SessionRouter.ts`

### Integrations

- [MCP Integration](https://github.com/jun516/qwen-code/blob/main/packages/core/src/mcp/oauth-token-storage.ts): `packages/core/src/mcp/oauth-token-storage.ts`
- [Browser Use](https://github.com/jun516/qwen-code/blob/main/packages/cua-driver/rust/crates/cua-driver-core/src/browser/engine.rs): `packages/cua-driver/rust/crates/cua-driver-core/src/browser/engine.rs`
- [Live Audio](https://github.com/jun516/qwen-code/blob/main/packages/live-host/src/preload/audio-engine.ts): `packages/live-host/src/preload/audio-engine.ts`
- [Memory Provider](https://github.com/jun516/qwen-code/blob/main/integrations/external-context-mem0/src/request-engine.ts): `integrations/external-context-mem0/src/request-engine.ts`

### Other components

- **User**
- **Model Provider**

## Connections

- User → Terminal CLI: starts in project (evidence: `README.md`)
- User → Desktop App: uses (evidence: `README.md`)
- User → Web UI: opens (evidence: `README.md`)
- User → VS Code Companion: integrates with (evidence: `README.md`)
- User → Chat Channels: connects through (evidence: `README.md`)
- User → SDK Clients: automates with (evidence: `README.md`)
- User → ACP Daemon: starts with qwen serve (evidence: `README.md`)
- User → Model Provider: configures provider (evidence: `README.md`)
- Terminal CLI → Session Engine: runs coding tasks
- ACP Daemon → Session Engine: serves sessions
- Session Engine → Model Generation: generates responses
- Session Engine → Auto Memory: uses memory
- Session Engine → Skills: uses skills
- Session Engine → MCP Integration: connects tools
- Session Engine → Browser Use: uses browser tools
- Session Engine → Live Audio: supports live mode
- Session Engine → Transcript Compaction: compacts replay
- Managed Sessions → Runtime Broker: dispatches lifecycle
- Managed Sessions → Managed Session Log: records session state
- Chat Channels → Channel Routing: routes messages
- Auto Memory → Memory Provider: queries provider
