# heydarey/termuxpro architecture

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

- Interactive diagram: https://gitdiagram.com/heydarey/termuxpro
- Repository: https://github.com/heydarey/termuxpro

## Overview

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: [`app/src/main/java/com/termux/app/RemoteCommandRunner.java`](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/RemoteCommandRunner.java) (SSH commands), [`app/src/main/java/com/termux/app/TermuxActivity.java`](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/TermuxActivity.java) (Terminal activity), [`terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java`](https://github.com/heydarey/termuxpro/blob/master/terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java) (PTY session), [`app/src/main/java/com/termux/app/WorkspaceActivity.java`](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/WorkspaceActivity.java) (Workspace UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace features"]
  node_workspace_ui["Workspace UI"]
  node_ssh_command["SSH commands"]
  node_workspace_state[("Workspace state")]
  node_ai_cli["AI CLI sessions"]
  node_git["Git workbench"]
  node_remote_files["Remote files"]
  node_project_tasks["Project tasks"]
  node_tmux_tasks["Task sessions"]
  node_connection_diagnostics["SSH diagnostics"]
  node_ssh_keys["SSH keys"]
  node_web_preview["Web preview"]
end

subgraph group_terminal["Local terminal"]
  node_terminal_activity["Terminal activity"]
  node_terminal_view["Terminal view<br/>[TerminalView.java]"]
  node_terminal_session["PTY session"]
  node_terminal_emulator["Terminal emulator"]
  node_session_client["Session client"]
end

subgraph group_runtime["App runtime"]
  node_app_service["Termux service<br/>[TermuxService.java]"]
  node_termux_session["Session runner<br/>[TermuxSession.java]"]
  node_local_linux["Local Linux<br/>[termux-bootstrap.c]"]
  node_command_runner["Command service"]
end

node_user(("User"))

node_user -->|"opens workspace"| node_workspace_ui
node_workspace_ui -.->|"loads configuration"| node_workspace_state
node_workspace_ui -.->|"starts remote work"| node_ssh_command
node_ssh_command -.->|"launches CLI"| node_ai_cli
node_ssh_command -.->|"runs Git actions"| node_git
node_ssh_command -.->|"serves browsing"| node_remote_files
node_ssh_command -.->|"detects tasks"| node_project_tasks
node_ssh_command -.->|"manages sessions"| node_tmux_tasks
node_ssh_command -.->|"checks connection"| node_connection_diagnostics
node_ssh_command -.->|"manages keys"| node_ssh_keys
node_ssh_command -.->|"opens tunnel"| node_web_preview
node_user -->|"opens terminal"| node_terminal_activity
node_terminal_activity -->|"binds service"| node_app_service
node_app_service -->|"creates sessions"| node_termux_session
node_termux_session -->|"starts PTY"| node_terminal_session
node_terminal_activity -->|"coordinates session"| node_session_client
node_terminal_activity -.->|"renders terminal"| node_terminal_view
node_terminal_session -.->|"feeds output"| node_terminal_emulator
node_terminal_view -.->|"sends input"| node_terminal_session
node_terminal_session -.->|"notifies changes"| node_session_client
node_user -.->|"requests command"| node_command_runner
node_command_runner -->|"dispatches command"| node_app_service
node_termux_session -.->|"runs shell"| node_local_linux

click node_workspace_ui "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/WorkspaceActivity.java"
click node_ssh_command "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/RemoteCommandRunner.java"
click node_workspace_state "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/WorkspaceTargetStore.java"
click node_ai_cli "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/AiCliLaunchCommand.java"
click node_git "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/GitDiffActivity.java"
click node_remote_files "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/RemoteFilesActivity.java"
click node_project_tasks "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/ProjectTasksActivity.java"
click node_tmux_tasks "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/TaskSessionsActivity.java"
click node_connection_diagnostics "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/ConnectionDiagnosticActivity.java"
click node_ssh_keys "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/SshKeysActivity.java"
click node_web_preview "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/WebPreviewNavigation.java"
click node_terminal_activity "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/TermuxActivity.java"
click node_terminal_view "https://github.com/heydarey/termuxpro/blob/master/terminal-view/src/main/java/com/termux/view/TerminalView.java"
click node_terminal_session "https://github.com/heydarey/termuxpro/blob/master/terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java"
click node_terminal_emulator "https://github.com/heydarey/termuxpro/blob/master/terminal-emulator/src/main/java/com/termux/terminal/TerminalEmulator.java"
click node_session_client "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java"
click node_app_service "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/TermuxService.java"
click node_termux_session "https://github.com/heydarey/termuxpro/blob/master/termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java"
click node_local_linux "https://github.com/heydarey/termuxpro/blob/master/app/src/main/cpp/termux-bootstrap.c"
click node_command_runner "https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/RunCommandService.java"

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_workspace_ui,node_ssh_command,node_workspace_state,node_ai_cli,node_git,node_remote_files,node_project_tasks,node_tmux_tasks,node_connection_diagnostics,node_ssh_keys,node_web_preview,node_user toneBlue
class node_terminal_activity,node_terminal_view,node_terminal_session,node_terminal_emulator,node_session_client toneAmber
class node_app_service,node_termux_session,node_local_linux,node_command_runner toneMint
```

## Components

### Workspace features

- [Workspace UI](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/WorkspaceActivity.java): `app/src/main/java/com/termux/app/WorkspaceActivity.java`
- [SSH commands](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/RemoteCommandRunner.java): `app/src/main/java/com/termux/app/RemoteCommandRunner.java`
- [Workspace state](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/WorkspaceTargetStore.java): `app/src/main/java/com/termux/app/WorkspaceTargetStore.java`
- [AI CLI sessions](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/AiCliLaunchCommand.java): `app/src/main/java/com/termux/app/AiCliLaunchCommand.java`
- [Git workbench](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/GitDiffActivity.java): `app/src/main/java/com/termux/app/GitDiffActivity.java`
- [Remote files](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/RemoteFilesActivity.java): `app/src/main/java/com/termux/app/RemoteFilesActivity.java`
- [Project tasks](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/ProjectTasksActivity.java): `app/src/main/java/com/termux/app/ProjectTasksActivity.java`
- [Task sessions](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/TaskSessionsActivity.java): `app/src/main/java/com/termux/app/TaskSessionsActivity.java`
- [SSH diagnostics](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/ConnectionDiagnosticActivity.java): `app/src/main/java/com/termux/app/ConnectionDiagnosticActivity.java`
- [SSH keys](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/SshKeysActivity.java): `app/src/main/java/com/termux/app/SshKeysActivity.java`
- [Web preview](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/WebPreviewNavigation.java): `app/src/main/java/com/termux/app/WebPreviewNavigation.java`

### Local terminal

- [Terminal activity](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/TermuxActivity.java): `app/src/main/java/com/termux/app/TermuxActivity.java`
- [Terminal view](https://github.com/heydarey/termuxpro/blob/master/terminal-view/src/main/java/com/termux/view/TerminalView.java): `terminal-view/src/main/java/com/termux/view/TerminalView.java`
- [PTY session](https://github.com/heydarey/termuxpro/blob/master/terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java): `terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java`
- [Terminal emulator](https://github.com/heydarey/termuxpro/blob/master/terminal-emulator/src/main/java/com/termux/terminal/TerminalEmulator.java): `terminal-emulator/src/main/java/com/termux/terminal/TerminalEmulator.java`
- [Session client](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java): `app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java`

### App runtime

- [Termux service](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/TermuxService.java): `app/src/main/java/com/termux/app/TermuxService.java`
- [Session runner](https://github.com/heydarey/termuxpro/blob/master/termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java): `termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java`
- [Local Linux](https://github.com/heydarey/termuxpro/blob/master/app/src/main/cpp/termux-bootstrap.c): `app/src/main/cpp/termux-bootstrap.c`
- [Command service](https://github.com/heydarey/termuxpro/blob/master/app/src/main/java/com/termux/app/RunCommandService.java): `app/src/main/java/com/termux/app/RunCommandService.java`

### Other components

- **User**

## Connections

- User → Workspace UI: opens workspace (evidence: `README.md`)
- Workspace UI → Workspace state: loads configuration
- Workspace UI → SSH commands: starts remote work
- SSH commands → AI CLI sessions: launches CLI (evidence: `README.md`)
- SSH commands → Git workbench: runs Git actions (evidence: `README.md`)
- SSH commands → Remote files: serves browsing (evidence: `README.md`)
- SSH commands → Project tasks: detects tasks (evidence: `README.md`)
- SSH commands → Task sessions: manages sessions (evidence: `README.md`)
- SSH commands → SSH diagnostics: checks connection (evidence: `README.md`)
- SSH commands → SSH keys: manages keys (evidence: `README.md`)
- SSH commands → Web preview: opens tunnel (evidence: `README.md`)
- User → Terminal activity: opens terminal (evidence: `README.md`)
- Terminal activity → Termux service: binds service (evidence: `app/src/main/java/com/termux/app/TermuxActivity.java`)
- Termux service → Session runner: creates sessions (evidence: `app/src/main/java/com/termux/app/TermuxService.java`)
- Session runner → PTY session: starts PTY (evidence: `termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java`)
- Terminal activity → Session client: coordinates session (evidence: `app/src/main/java/com/termux/app/TermuxActivity.java`)
- Terminal activity → Terminal view: renders terminal (evidence: `app/src/main/java/com/termux/app/TermuxActivity.java`)
- PTY session → Terminal emulator: feeds output (evidence: `terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java`)
- Terminal view → PTY session: sends input (evidence: `terminal-view/src/main/java/com/termux/view/TerminalView.java`)
- PTY session → Session client: notifies changes (evidence: `app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java`)
- User → Command service: requests command
- Command service → Termux service: dispatches command (evidence: `app/src/main/java/com/termux/app/RunCommandService.java`)
- Session runner → Local Linux: runs shell
