How the-jddev/leo-shs-lab works
Leo is an Android voice-and-chat assistant that accepts user requests, interprets them, consults an AI provider, and can carry out device and app actions. Its runtime also includes persistent conversational memory, browser and file operations, GitHub integration, and floating assistant overlays. The excerpts confirm several internal dependencies; other connections are omitted where the supplied source does not establish wiring. The README is empty, so capability coverage is based on the source tree and sampled code.
Main entry points: MainActivity.kt Main activity · ActionExecutor.kt Action executor · LeoNetworkClient.kt AI client · GitManager.kt Git integration
Components 26
Assistant interaction
- Main activity
android-leo/app/src/main/java/com/shslab/leo/MainActivity.kt - Chat UI
android-leo/app/src/main/java/com/shslab/leo/chat/ChatAdapter.kt - Voice interaction
android-leo/app/src/main/java/com/shslab/leo/voice/LeoVoiceService.kt - Speech manager
android-leo/app/src/main/java/com/shslab/leo/voice/SpeechManager.kt
Conversation services
- AI client
android-leo/app/src/main/java/com/shslab/leo/network/LeoNetworkClient.kt - Assistant persona
android-leo/app/src/main/java/com/shslab/leo/persona/DoraemonPersona.kt - Memory manager
android-leo/app/src/main/java/com/shslab/leo/memory/MemoryManager.kt - Memory database
android-leo/app/src/main/java/com/shslab/leo/memory/LeoMemoryDb.kt - Credential vault
android-leo/app/src/main/java/com/shslab/leo/security/SecurityManager.kt
Action capabilities
- Command parser
android-leo/app/src/main/java/com/shslab/leo/parser/CommandParser.kt - Action dispatcher
android-leo/app/src/main/java/com/shslab/leo/executor/ActionDispatcher.kt - Action executor
android-leo/app/src/main/java/com/shslab/leo/executor/ActionExecutor.kt - Command queue
android-leo/app/src/main/java/com/shslab/leo/executor/CommandQueue.kt - Screen automation
android-leo/app/src/main/java/com/shslab/leo/accessibility/LeoAccessibilityService.kt - Browser engine
android-leo/app/src/main/java/com/shslab/leo/browser/LeoBrowserEngine.kt - File engine
android-leo/app/src/main/java/com/shslab/leo/file/FileEngine.kt - Deletion safeguard
android-leo/app/src/main/java/com/shslab/leo/cognitive/CognitiveCleaner.kt - Hardware controls
android-leo/app/src/main/java/com/shslab/leo/hardware/HardwareManager.kt - Git integration
android-leo/app/src/main/java/com/shslab/leo/git/GitManager.kt - Shell bridge
android-leo/app/src/main/java/com/shslab/leo/shell/ShellBridge.kt
Android services
- Floating overlay
android-leo/app/src/main/java/com/shslab/leo/overlay/OverlayService.kt - Voice bubble
android-leo/app/src/main/java/com/shslab/leo/overlay/SiriOverlayService.kt
Other components
- User
- AI provider
- Android system
- GitHub
Connections 29
- User → Main activity: submits request
- Voice interaction → Main activity: launches assistant
- Main activity → Chat UI: updates conversation
- Main activity → Speech manager: uses speech
- Main activity → Command parser: parses command
- Main activity → AI client: requests response
- AI client → Assistant persona: uses persona
- AI client → Memory manager: builds memory context
- AI client → Credential vault: reads credentials
- AI client → AI provider: sends request
- Memory manager → Memory database: reads and writes
- Main activity → Action dispatcher: dispatches actions
- Action dispatcher → Command queue: queues commands
- Action dispatcher → Action executor: dispatches action
- Action executor → Screen automation: controls apps
- Action executor → Browser engine: uses browser
- Action executor → File engine: uses file engine
- File engine → Deletion safeguard: checks deletion
- Action executor → Hardware controls: controls hardware
- Action executor → Git integration: uses Git integration
- Git integration → Credential vault: reads token
- Git integration → Shell bridge: runs Git commands
- Git integration → GitHub: calls API
- Voice interaction → Android system: registers assistant
- Screen automation → Android system: uses accessibility APIs
- Hardware controls → Android system: controls device
- Floating overlay → Android system: shows system overlay
- Voice bubble → Main activity: opens voice mode
- Voice bubble → Android system: samples microphone