# yhdmgf/aiverse architecture

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

- Interactive diagram: https://gitdiagram.com/yhdmgf/aiverse
- Repository: https://github.com/yhdmgf/aiverse

## Overview

AiVerse is an Android AI coding agent and mobile development environment. The principal flow is a user-configured model and workspace feeding an agent conversation; the agent plans and streams model responses, applies permission checks to tool actions, executes against a local container or remote SSH backend, and persists session state. The README also documents terminal, search, MCP, plugins, backups, and workspace sync. Some of these feature directories are absent from the supplied tree, so those capabilities are represented only where an exact path is supported; documented relationships are cited to the README rather than implying unsampled calls.

Main entry points: [`app/src/main/java/com/aiverse/feature/agent/domain/workflow/AgentWorkflow.kt`](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/workflow/AgentWorkflow.kt) (Agent workflow), [`app/src/main/java/com/aiverse/feature/agent/domain/tool/AgentTool.kt`](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/tool/AgentTool.kt) (Agent tools), [`app/src/main/java/com/aiverse/feature/settings/presentation/SettingsViewModel.kt`](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/settings/presentation/SettingsViewModel.kt) (Model settings), [`app/src/main/java/com/aiverse/feature/agent/domain/provider/AIProvider.kt`](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/provider/AIProvider.kt) (Model providers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent["Agent workflow"]
  node_agent_ui["Agent conversation UI"]
  node_workflow["Agent workflow<br/>[AgentWorkflow.kt]"]
  node_context["Context compaction"]
  node_tools["Agent tools<br/>[AgentTool.kt]"]
  node_permissions["Tool permissions"]
  node_memory_skills["Memory and skills"]
end

subgraph group_execution["Execution environment"]
  node_container["Local container"]
  node_remote["Remote SSH<br/>[RemoteSshEngine.kt]"]
  node_terminal["Terminal session"]
  node_terminal_view["Terminal view<br/>[TerminalView.java]"]
  node_sync["Workspace sync<br/>[SyncEngine.kt]"]
end

subgraph group_integrations["Integrations"]
  node_providers["Model providers<br/>[AIProvider.kt]"]
  node_provider_adapters["Provider adapters<br/>[OpenAIAdapter.kt]"]
  node_mcp["MCP connections<br/>[McpManager.kt]"]
  node_search["Web search"]
  node_plugins["Plugin sessions"]
  node_model_service["Model metadata"]
end

subgraph group_app["App and state"]
  node_main["Android app entry<br/>[MainActivity.kt]"]
  node_sessions["Session state<br/>[SessionUseCase.kt]"]
  node_database[("Agent database<br/>[AgentDatabase.kt]")]
  node_backup["Backup and restore"]
  node_settings["Model settings"]
end

node_user(("Developer"))

node_user -->|"opens app"| node_main
node_main -->|"starts conversation"| node_agent_ui
node_user -->|"configures model"| node_settings
node_settings -.->|"selects provider"| node_providers
node_settings -->|"loads metadata"| node_model_service
node_agent_ui -.->|"submits request"| node_workflow
node_workflow -.->|"requests completion"| node_providers
node_providers -.->|"dispatches protocol"| node_provider_adapters
node_workflow -.->|"compacts context"| node_context
node_workflow -.->|"dispatches tools"| node_tools
node_tools -->|"checks authorization"| node_permissions
node_tools -->|"executes locally"| node_container
node_tools -->|"executes remotely"| node_remote
node_user -->|"uses terminal"| node_terminal_view
node_terminal_view -.->|"renders session"| node_terminal
node_container -->|"hosts shell"| node_terminal
node_workflow -.->|"updates session"| node_sessions
node_sessions -.->|"persists messages"| node_database
node_workflow -->|"uses learned context"| node_memory_skills
node_workflow -->|"extends toolset"| node_mcp
node_workflow -->|"searches web"| node_search
node_plugins -.->|"exposes sessions"| node_user
node_user -->|"backs up data"| node_backup
node_user -->|"syncs workspace"| node_sync

click node_main "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/MainActivity.kt"
click node_agent_ui "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/presentation/AIAgentViewModel.kt"
click node_workflow "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/workflow/AgentWorkflow.kt"
click node_context "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/workflow/ContextCompactor.kt"
click node_providers "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/provider/AIProvider.kt"
click node_provider_adapters "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/provider/OpenAIAdapter.kt"
click node_tools "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/tool/AgentTool.kt"
click node_permissions "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/permission/ToolPermissionPolicyEngine.kt"
click node_container "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/container/LinuxContainerEngine.kt"
click node_remote "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/container/RemoteSshEngine.kt"
click node_terminal "https://github.com/yhdmgf/aiverse/blob/main/terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java"
click node_terminal_view "https://github.com/yhdmgf/aiverse/blob/main/terminal-view/src/main/java/com/termux/view/TerminalView.java"
click node_sessions "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/session/SessionUseCase.kt"
click node_database "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/data/local/database/AgentDatabase.kt"
click node_memory_skills "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/memory/MemoryRepository.kt"
click node_mcp "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/mcp/McpManager.kt"
click node_search "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/search/domain/ExaSearchService.kt"
click node_plugins "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/plugins/runtime/PluginSessionSourceService.kt"
click node_backup "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/backup/data/BackupManagerImpl.kt"
click node_sync "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/workspace/domain/remote/SyncEngine.kt"
click node_settings "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/settings/presentation/SettingsViewModel.kt"
click node_model_service "https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/settings/data/remote/ModelMetadataService.kt"

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_agent_ui,node_workflow,node_context,node_tools,node_permissions,node_memory_skills toneBlue
class node_container,node_remote,node_terminal,node_terminal_view,node_sync toneAmber
class node_providers,node_provider_adapters,node_mcp,node_search,node_plugins,node_model_service toneMint
class node_main,node_sessions,node_database,node_backup,node_settings toneRose
class node_user toneIndigo
```

## Components

### Agent workflow

- [Agent conversation UI](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/presentation/AIAgentViewModel.kt): `app/src/main/java/com/aiverse/feature/agent/presentation/AIAgentViewModel.kt`
- [Agent workflow](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/workflow/AgentWorkflow.kt): `app/src/main/java/com/aiverse/feature/agent/domain/workflow/AgentWorkflow.kt`
- [Context compaction](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/workflow/ContextCompactor.kt): `app/src/main/java/com/aiverse/feature/agent/domain/workflow/ContextCompactor.kt`
- [Agent tools](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/tool/AgentTool.kt): `app/src/main/java/com/aiverse/feature/agent/domain/tool/AgentTool.kt`
- [Tool permissions](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/permission/ToolPermissionPolicyEngine.kt): `app/src/main/java/com/aiverse/feature/agent/domain/permission/ToolPermissionPolicyEngine.kt`
- [Memory and skills](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/memory/MemoryRepository.kt): `app/src/main/java/com/aiverse/feature/agent/domain/memory/MemoryRepository.kt`

### Execution environment

- [Local container](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/container/LinuxContainerEngine.kt): `app/src/main/java/com/aiverse/feature/agent/domain/container/LinuxContainerEngine.kt`
- [Remote SSH](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/container/RemoteSshEngine.kt): `app/src/main/java/com/aiverse/feature/agent/domain/container/RemoteSshEngine.kt`
- [Terminal session](https://github.com/yhdmgf/aiverse/blob/main/terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java): `terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java`
- [Terminal view](https://github.com/yhdmgf/aiverse/blob/main/terminal-view/src/main/java/com/termux/view/TerminalView.java): `terminal-view/src/main/java/com/termux/view/TerminalView.java`
- [Workspace sync](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/workspace/domain/remote/SyncEngine.kt): `app/src/main/java/com/aiverse/feature/workspace/domain/remote/SyncEngine.kt`

### Integrations

- [Model providers](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/provider/AIProvider.kt): `app/src/main/java/com/aiverse/feature/agent/domain/provider/AIProvider.kt`
- [Provider adapters](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/provider/OpenAIAdapter.kt): `app/src/main/java/com/aiverse/feature/agent/domain/provider/OpenAIAdapter.kt`
- [MCP connections](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/mcp/McpManager.kt): `app/src/main/java/com/aiverse/feature/agent/domain/mcp/McpManager.kt`
- [Web search](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/search/domain/ExaSearchService.kt): `app/src/main/java/com/aiverse/feature/search/domain/ExaSearchService.kt`
- [Plugin sessions](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/plugins/runtime/PluginSessionSourceService.kt): `app/src/main/java/com/aiverse/feature/plugins/runtime/PluginSessionSourceService.kt`
- [Model metadata](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/settings/data/remote/ModelMetadataService.kt): `app/src/main/java/com/aiverse/feature/settings/data/remote/ModelMetadataService.kt`

### App and state

- [Android app entry](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/MainActivity.kt): `app/src/main/java/com/aiverse/MainActivity.kt`
- [Session state](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/domain/session/SessionUseCase.kt): `app/src/main/java/com/aiverse/feature/agent/domain/session/SessionUseCase.kt`
- [Agent database](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/agent/data/local/database/AgentDatabase.kt): `app/src/main/java/com/aiverse/feature/agent/data/local/database/AgentDatabase.kt`
- [Backup and restore](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/backup/data/BackupManagerImpl.kt): `app/src/main/java/com/aiverse/feature/backup/data/BackupManagerImpl.kt`
- [Model settings](https://github.com/yhdmgf/aiverse/blob/main/app/src/main/java/com/aiverse/feature/settings/presentation/SettingsViewModel.kt): `app/src/main/java/com/aiverse/feature/settings/presentation/SettingsViewModel.kt`

### Other components

- **Developer**

## Connections

- Developer → Android app entry: opens app (evidence: `README.md`)
- Android app entry → Agent conversation UI: starts conversation (evidence: `README.md`)
- Developer → Model settings: configures model (evidence: `README.md`)
- Model settings → Model providers: selects provider
- Model settings → Model metadata: loads metadata (evidence: `app/src/main/java/com/aiverse/feature/settings/data/remote/ModelMetadataService.kt`)
- Agent conversation UI → Agent workflow: submits request
- Agent workflow → Model providers: requests completion
- Model providers → Provider adapters: dispatches protocol
- Agent workflow → Context compaction: compacts context
- Agent workflow → Agent tools: dispatches tools
- Agent tools → Tool permissions: checks authorization (evidence: `app/src/main/java/com/aiverse/feature/agent/domain/permission/ToolPermissionPolicyEngine.kt`)
- Agent tools → Local container: executes locally (evidence: `README.md`)
- Agent tools → Remote SSH: executes remotely (evidence: `README.md`)
- Developer → Terminal view: uses terminal (evidence: `README.md`)
- Terminal view → Terminal session: renders session (evidence: `terminal-view/src/main/java/com/termux/view/TerminalView.java`)
- Local container → Terminal session: hosts shell (evidence: `README.md`)
- Agent workflow → Session state: updates session
- Session state → Agent database: persists messages
- Agent workflow → Memory and skills: uses learned context (evidence: `README.md`)
- Agent workflow → MCP connections: extends toolset (evidence: `README.md`)
- Agent workflow → Web search: searches web (evidence: `README.md`)
- Plugin sessions → Developer: exposes sessions
- Developer → Backup and restore: backs up data (evidence: `README.md`)
- Developer → Workspace sync: syncs workspace (evidence: `README.md`)
