# agentgear/deveco-code architecture

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

- Interactive diagram: https://gitdiagram.com/agentgear/deveco-code
- Repository: https://github.com/agentgear/deveco-code

## Overview

DevEco Code is a HarmonyOS-focused AI coding agent built on OpenCode. Its main workflow starts in the terminal: the user describes a development task, the agent uses model and extension capabilities to work with project code, and HarmonyOS tooling can build, run, inspect, or debug the result. The tree and excerpts support the CLI, TUI, server, LLM, and persistence layers; the README documents HarmonyOS tools and extension capabilities whose implementation details were not sampled, so those links are marked unverified.

Main entry points: [`packages/opencode/src`](https://github.com/agentgear/deveco-code/tree/develop/packages/opencode/src) (Agent capabilities), [`packages/tui/src/app.tsx`](https://github.com/agentgear/deveco-code/blob/develop/packages/tui/src/app.tsx) (Terminal interface), [`packages/opencode/src/plugin/deveco`](https://github.com/agentgear/deveco-code/tree/develop/packages/opencode/src/plugin/deveco) (HarmonyOS tools), [`packages/cli/src/commands/commands.ts`](https://github.com/agentgear/deveco-code/blob/develop/packages/cli/src/commands/commands.ts) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and interaction"]
  node_cli["CLI commands<br/>[commands.ts]"]
  node_tui["Terminal interface<br/>[app.tsx]"]
  node_route["Session routing<br/>[route.tsx]"]
  node_review["Code review UI<br/>[session-review.tsx]"]
end

subgraph group_runtime["Agent runtime"]
  node_server["Agent server<br/>[routes.ts]"]
  node_handlers["API handlers<br/>[handlers.ts]"]
  node_opencode["Agent capabilities"]
end

subgraph group_harmony["HarmonyOS development"]
  node_deveco_integration["HarmonyOS tools"]
end

subgraph group_extensions["Models and extensions"]
  node_llm["Model routing<br/>[client.ts]"]
  node_providers["Model providers"]
  node_extensions_api["Skills MCP plugins"]
end

subgraph group_persistence["Local state"]
  node_local_storage[("Agent storage<br/>[storage.ts]")]
  node_auth_storage[("Login storage<br/>[storage.ts]")]
  node_enterprise_storage[("Remote storage<br/>[storage.ts]")]
end

node_developer(("Developer"))
node_toolchain["DevEco Studio"]

node_developer -->|"starts"| node_cli
node_cli -.->|"opens interface"| node_tui
node_tui -->|"selects session"| node_route
node_tui -.->|"uses API"| node_server
node_server -->|"provides handlers"| node_handlers
node_handlers -.->|"uses agent capabilities"| node_opencode
node_opencode -.->|"requests generation"| node_llm
node_llm -.->|"routes requests"| node_providers
node_opencode -.->|"uses HarmonyOS tools"| node_deveco_integration
node_deveco_integration -.->|"invokes tools"| node_toolchain
node_opencode -.->|"supports extensions"| node_extensions_api
node_tui -.->|"shows review"| node_review
node_opencode -.->|"persists state"| node_local_storage
node_deveco_integration -.->|"stores credentials"| node_auth_storage
node_opencode -.->|"uses remote storage"| node_enterprise_storage

click node_cli "https://github.com/agentgear/deveco-code/blob/develop/packages/cli/src/commands/commands.ts"
click node_tui "https://github.com/agentgear/deveco-code/blob/develop/packages/tui/src/app.tsx"
click node_route "https://github.com/agentgear/deveco-code/blob/develop/packages/tui/src/context/route.tsx"
click node_server "https://github.com/agentgear/deveco-code/blob/develop/packages/server/src/routes.ts"
click node_handlers "https://github.com/agentgear/deveco-code/blob/develop/packages/server/src/handlers.ts"
click node_opencode "https://github.com/agentgear/deveco-code/tree/develop/packages/opencode/src"
click node_llm "https://github.com/agentgear/deveco-code/blob/develop/packages/llm/src/route/client.ts"
click node_providers "https://github.com/agentgear/deveco-code/tree/develop/packages/llm/src/providers"
click node_extensions_api "https://github.com/agentgear/deveco-code/tree/develop/packages/opencode/src/plugin"
click node_deveco_integration "https://github.com/agentgear/deveco-code/tree/develop/packages/opencode/src/plugin/deveco"
click node_review "https://github.com/agentgear/deveco-code/blob/develop/packages/ui/src/components/session-review.tsx"
click node_local_storage "https://github.com/agentgear/deveco-code/blob/develop/packages/opencode/src/storage/storage.ts"
click node_auth_storage "https://github.com/agentgear/deveco-code/blob/develop/packages/opencode/src/plugin/deveco/storage.ts"
click node_enterprise_storage "https://github.com/agentgear/deveco-code/blob/develop/packages/enterprise/src/core/storage.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_cli,node_tui,node_route,node_review toneBlue
class node_server,node_handlers,node_opencode toneAmber
class node_deveco_integration toneMint
class node_llm,node_providers,node_extensions_api toneRose
class node_local_storage,node_auth_storage,node_enterprise_storage,node_developer,node_toolchain toneIndigo
```

## Components

### CLI and interaction

- [CLI commands](https://github.com/agentgear/deveco-code/blob/develop/packages/cli/src/commands/commands.ts): `packages/cli/src/commands/commands.ts`
- [Terminal interface](https://github.com/agentgear/deveco-code/blob/develop/packages/tui/src/app.tsx): `packages/tui/src/app.tsx`
- [Session routing](https://github.com/agentgear/deveco-code/blob/develop/packages/tui/src/context/route.tsx): `packages/tui/src/context/route.tsx`
- [Code review UI](https://github.com/agentgear/deveco-code/blob/develop/packages/ui/src/components/session-review.tsx): `packages/ui/src/components/session-review.tsx`

### Agent runtime

- [Agent server](https://github.com/agentgear/deveco-code/blob/develop/packages/server/src/routes.ts): `packages/server/src/routes.ts`
- [API handlers](https://github.com/agentgear/deveco-code/blob/develop/packages/server/src/handlers.ts): `packages/server/src/handlers.ts`
- [Agent capabilities](https://github.com/agentgear/deveco-code/tree/develop/packages/opencode/src): `packages/opencode/src`

### HarmonyOS development

- [HarmonyOS tools](https://github.com/agentgear/deveco-code/tree/develop/packages/opencode/src/plugin/deveco): `packages/opencode/src/plugin/deveco`

### Models and extensions

- [Model routing](https://github.com/agentgear/deveco-code/blob/develop/packages/llm/src/route/client.ts): `packages/llm/src/route/client.ts`
- [Model providers](https://github.com/agentgear/deveco-code/tree/develop/packages/llm/src/providers): `packages/llm/src/providers`
- [Skills MCP plugins](https://github.com/agentgear/deveco-code/tree/develop/packages/opencode/src/plugin): `packages/opencode/src/plugin`

### Local state

- [Agent storage](https://github.com/agentgear/deveco-code/blob/develop/packages/opencode/src/storage/storage.ts): `packages/opencode/src/storage/storage.ts`
- [Login storage](https://github.com/agentgear/deveco-code/blob/develop/packages/opencode/src/plugin/deveco/storage.ts): `packages/opencode/src/plugin/deveco/storage.ts`
- [Remote storage](https://github.com/agentgear/deveco-code/blob/develop/packages/enterprise/src/core/storage.ts): `packages/enterprise/src/core/storage.ts`

### Other components

- **Developer**
- **DevEco Studio**

## Connections

- Developer → CLI commands: starts (evidence: `README.md`)
- CLI commands → Terminal interface: opens interface
- Terminal interface → Session routing: selects session (evidence: `packages/tui/src/app.tsx`)
- Terminal interface → Agent server: uses API
- Agent server → API handlers: provides handlers (evidence: `packages/server/src/routes.ts`)
- API handlers → Agent capabilities: uses agent capabilities
- Agent capabilities → Model routing: requests generation
- Model routing → Model providers: routes requests
- Agent capabilities → HarmonyOS tools: uses HarmonyOS tools (evidence: `README.md`)
- HarmonyOS tools → DevEco Studio: invokes tools (evidence: `README.md`)
- Agent capabilities → Skills MCP plugins: supports extensions (evidence: `README.md`)
- Terminal interface → Code review UI: shows review
- Agent capabilities → Agent storage: persists state
- HarmonyOS tools → Login storage: stores credentials
- Agent capabilities → Remote storage: uses remote storage
