How yhdmgf/aiverse works
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: AgentWorkflow.kt Agent workflow · AgentTool.kt Agent tools · SettingsViewModel.kt Model settings · AIProvider.kt Model providers
Components 23
Agent workflow
- Agent conversation UI
app/src/main/java/com/aiverse/feature/agent/presentation/AIAgentViewModel.kt - Agent workflow
app/src/main/java/com/aiverse/feature/agent/domain/workflow/AgentWorkflow.kt - Context compaction
app/src/main/java/com/aiverse/feature/agent/domain/workflow/ContextCompactor.kt - Agent tools
app/src/main/java/com/aiverse/feature/agent/domain/tool/AgentTool.kt - Tool permissions
app/src/main/java/com/aiverse/feature/agent/domain/permission/ToolPermissionPolicyEngine.kt - Memory and skills
app/src/main/java/com/aiverse/feature/agent/domain/memory/MemoryRepository.kt
Execution environment
- Local container
app/src/main/java/com/aiverse/feature/agent/domain/container/LinuxContainerEngine.kt - Remote SSH
app/src/main/java/com/aiverse/feature/agent/domain/container/RemoteSshEngine.kt - Terminal session
terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java - Terminal view
terminal-view/src/main/java/com/termux/view/TerminalView.java - Workspace sync
app/src/main/java/com/aiverse/feature/workspace/domain/remote/SyncEngine.kt
Integrations
- Model providers
app/src/main/java/com/aiverse/feature/agent/domain/provider/AIProvider.kt - Provider adapters
app/src/main/java/com/aiverse/feature/agent/domain/provider/OpenAIAdapter.kt - MCP connections
app/src/main/java/com/aiverse/feature/agent/domain/mcp/McpManager.kt - Web search
app/src/main/java/com/aiverse/feature/search/domain/ExaSearchService.kt - Plugin sessions
app/src/main/java/com/aiverse/feature/plugins/runtime/PluginSessionSourceService.kt - Model metadata
app/src/main/java/com/aiverse/feature/settings/data/remote/ModelMetadataService.kt
App and state
- Android app entry
app/src/main/java/com/aiverse/MainActivity.kt - Session state
app/src/main/java/com/aiverse/feature/agent/domain/session/SessionUseCase.kt - Agent database
app/src/main/java/com/aiverse/feature/agent/data/local/database/AgentDatabase.kt - Backup and restore
app/src/main/java/com/aiverse/feature/backup/data/BackupManagerImpl.kt - Model settings
app/src/main/java/com/aiverse/feature/settings/presentation/SettingsViewModel.kt
Other components
- Developer
Connections 24
- Developer → Android app entry: opens app
README.md - Android app entry → Agent conversation UI: starts conversation
README.md - Developer → Model settings: configures model
README.md - Model settings → Model providers: selects provider
- Model settings → Model metadata: loads metadata
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
app/src/main/java/com/aiverse/feature/agent/domain/permission/ToolPermissionPolicyEngine.kt - Agent tools → Local container: executes locally
README.md - Agent tools → Remote SSH: executes remotely
README.md - Developer → Terminal view: uses terminal
README.md - Terminal view → Terminal session: renders session
terminal-view/src/main/java/com/termux/view/TerminalView.java - Local container → Terminal session: hosts shell
README.md - Agent workflow → Session state: updates session
- Session state → Agent database: persists messages
- Agent workflow → Memory and skills: uses learned context
README.md - Agent workflow → MCP connections: extends toolset
README.md - Agent workflow → Web search: searches web
README.md - Plugin sessions → Developer: exposes sessions
- Developer → Backup and restore: backs up data
README.md - Developer → Workspace sync: syncs workspace
README.md