How heydarey/termuxpro works
TermuxPro is an Android mobile development terminal combining the upstream Termux local Linux/PTY experience with touch-oriented SSH project workspaces. The main path is user → workspace or terminal UI → remote command/SSH-backed feature or local shell session → terminal output, with workspace-specific state and safety checks. The README also documents AI CLI launch/session handling, Git operations, remote files, task/tmux management, diagnostics, SSH keys, and loopback web preview. Feature source is mostly unsampled; those branches are included from documented capabilities, but their internal call edges are omitted where source evidence is unavailable.
Main entry points: RemoteCommandRunner.java SSH commands · TermuxActivity.java Terminal activity · TerminalSession.java PTY session · WorkspaceActivity.java Workspace UI
Components 21
Workspace features
- Workspace UI
app/src/main/java/com/termux/app/WorkspaceActivity.java - SSH commands
app/src/main/java/com/termux/app/RemoteCommandRunner.java - Workspace state
app/src/main/java/com/termux/app/WorkspaceTargetStore.java - AI CLI sessions
app/src/main/java/com/termux/app/AiCliLaunchCommand.java - Git workbench
app/src/main/java/com/termux/app/GitDiffActivity.java - Remote files
app/src/main/java/com/termux/app/RemoteFilesActivity.java - Project tasks
app/src/main/java/com/termux/app/ProjectTasksActivity.java - Task sessions
app/src/main/java/com/termux/app/TaskSessionsActivity.java - SSH diagnostics
app/src/main/java/com/termux/app/ConnectionDiagnosticActivity.java - SSH keys
app/src/main/java/com/termux/app/SshKeysActivity.java - Web preview
app/src/main/java/com/termux/app/WebPreviewNavigation.java
Local terminal
- Terminal activity
app/src/main/java/com/termux/app/TermuxActivity.java - Terminal view
terminal-view/src/main/java/com/termux/view/TerminalView.java - PTY session
terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java - Terminal emulator
terminal-emulator/src/main/java/com/termux/terminal/TerminalEmulator.java - Session client
app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java
App runtime
- Termux service
app/src/main/java/com/termux/app/TermuxService.java - Session runner
termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java - Local Linux
app/src/main/cpp/termux-bootstrap.c - Command service
app/src/main/java/com/termux/app/RunCommandService.java
Other components
- User
Connections 23
- User → Workspace UI: opens workspace
README.md - Workspace UI → Workspace state: loads configuration
- Workspace UI → SSH commands: starts remote work
- SSH commands → AI CLI sessions: launches CLI
README.md - SSH commands → Git workbench: runs Git actions
README.md - SSH commands → Remote files: serves browsing
README.md - SSH commands → Project tasks: detects tasks
README.md - SSH commands → Task sessions: manages sessions
README.md - SSH commands → SSH diagnostics: checks connection
README.md - SSH commands → SSH keys: manages keys
README.md - SSH commands → Web preview: opens tunnel
README.md - User → Terminal activity: opens terminal
README.md - Terminal activity → Termux service: binds service
app/src/main/java/com/termux/app/TermuxActivity.java - Termux service → Session runner: creates sessions
app/src/main/java/com/termux/app/TermuxService.java - Session runner → PTY session: starts PTY
termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java - Terminal activity → Session client: coordinates session
app/src/main/java/com/termux/app/TermuxActivity.java - Terminal activity → Terminal view: renders terminal
app/src/main/java/com/termux/app/TermuxActivity.java - PTY session → Terminal emulator: feeds output
terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java - Terminal view → PTY session: sends input
terminal-view/src/main/java/com/termux/view/TerminalView.java - PTY session → Session client: notifies changes
app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java - User → Command service: requests command
- Command service → Termux service: dispatches command
app/src/main/java/com/termux/app/RunCommandService.java - Session runner → Local Linux: runs shell