How wkbin/taixu works
TaiXu is an Android Linux runtime and AI automation workspace. The main journey is user intent through Agent planning and approved tool execution toward files, processes, or build artifacts; workflows add persistence, scheduling, and human approval. The graph also retains major documented capabilities such as terminal, browser, Git, MCP, and host automation. Some subsystems are documented in the README but their implementation was not sampled, so their internal wiring is intentionally limited.
Main entry points: harness Agent Harness · runtime Linux Runtime · AppDatabase.kt Room Persistence · TerminalScreen.kt PTY Terminal
Components 24
User Interaction
- App Navigation
feature/navigation/src/main/java/top/wkbin/taixu/ui/navigation/TaiXuNavHost.kt - Agent Chat
feature/chat/src/main/java/top/wkbin/taixu/ui/chat/ChatScreen.kt - Storage Management
feature/settings/src/main/java/top/wkbin/taixu/ui/settings/StorageUsageScreen.kt
Agent and Workflows
- Agent Harness
harness/src/main/java/top/wkbin/taixu/harness - Approval Policy
harness/src/main/java/top/wkbin/taixu/harness/ApprovalPolicyEngine.kt - Workflow Editor
feature/workflow/src/main/java/top/wkbin/taixu/ui/workflow/WorkflowViewModel.kt - Workflow Scheduling
app/src/main/java/top/wkbin/taixu/workflow/WorkflowScheduleWorker.kt
Linux Workspace
- Linux Runtime
runtime - PTY Terminal
feature/terminal/src/main/java/top/wkbin/taixu/ui/terminal/TerminalScreen.kt - Native PTY
app/src/main/cpp/pty_native.c - Project Workspace
project-template/src/main/java/top/wkbin/taixu/template/ProjectTemplateEngine.kt - Local Model Runtime
runtime/src/main/java/top/wkbin/taixu/runtime/LocalLlmManager.kt - Storage Scanner
runtime/src/main/java/top/wkbin/taixu/runtime/StorageManager.kt
Browser and Integrations
- Model Services
- Git Workbench
feature/git/src/main/java/top/wkbin/taixu/ui/git/GitManager.kt - Browser UI
feature/browser/src/main/java/top/wkbin/taixu/ui/browser/BrowserScreen.kt - Browser Engine
runtime/browser/src/main/java/top/wkbin/taixu/runtime/browser/engine/AndroidInAppBrowserEngine.kt - MCP Tools
harness - Shizuku Host
runtime/src/main/java/top/wkbin/taixu/runtime/privilege/ShizukuHostUserService.kt
Persistence and Services
- Room Persistence
core/database/src/main/java/top/wkbin/taixu/core/database/AppDatabase.kt - Runtime Service
app/src/main/java/top/wkbin/taixu/runtime/service/RuntimeForegroundService.kt - Agent Service
app/src/main/java/top/wkbin/taixu/service/AgentForegroundService.kt
Other components
- User
- Android Host
Connections 28
- User → App Navigation: opens
- App Navigation → Agent Chat: routes to
- Agent Chat → Agent Harness: sends prompts
- Agent Harness → Model Services: requests completions
- Agent Harness → Approval Policy: checks policy
- Approval Policy → Room Persistence: records approvals
- Agent Harness → Linux Runtime: runs tools
- Agent Harness → MCP Tools: invokes tools
- Agent Harness → Room Persistence: persists sessions
- User → Workflow Editor: configures tasks
- Workflow Editor → Room Persistence: persists workflows
- Workflow Scheduling → Room Persistence: loads schedules
- Workflow Scheduling → Agent Harness: dispatches runs
- User → PTY Terminal: opens terminal
- PTY Terminal → Linux Runtime: opens sessions
- PTY Terminal → Native PTY: uses JNI
- User → Project Workspace: creates projects
- User → Git Workbench: manages repositories
- User → Browser UI: browses pages
- Browser UI → Browser Engine: controls tabs
- Browser Engine → Android Host: uses WebView
- User → Local Model Runtime: imports models
- Local Model Runtime → Linux Runtime: starts inference
- User → Storage Management: reviews usage
- Storage Management → Storage Scanner: scans and cleans
- Runtime Service → Linux Runtime: keeps runtime active
- Agent Service → Agent Harness: supports background runs
- Shizuku Host → Android Host: executes host commands