How ssfuisu/cortex works
Cortex is an Android terminal app providing a native Ubuntu userspace without virtualization or root. The main workflow starts in the terminal UI, obtains a managed session, launches a shell through the PTY bridge with Cortex’s runtime environment, then parses and renders terminal output. Separate branches provide bootstrap/runtime setup, session and background-service management, search and keyboard interaction, URL opening, settings, and app updates. Some feature wiring is documented in the README but its implementation was not sampled, so those relationships are cited there.
Main entry points: MainActivity.kt Main activity · TerminalView.kt Terminal view · TerminalSession.kt Terminal session · TerminalBuffer.kt Screen and scrollback
Components 25
Terminal interface
- Main activity
app/src/main/java/org/cortex/terminal/MainActivity.kt - Terminal view
app/src/main/java/org/cortex/terminal/view/TerminalView.kt - Virtual keys
app/src/main/java/org/cortex/terminal/view/ExtraKeysView.kt - Search bar
app/src/main/java/org/cortex/terminal/view/TerminalSearchBar.kt - Settings
app/src/main/java/org/cortex/terminal/SettingsActivity.kt
Terminal execution
- Session manager
app/src/main/java/org/cortex/terminal/session/SessionManager.kt - Terminal session
app/src/main/java/org/cortex/terminal/session/TerminalSession.kt - PTY process
app/src/main/java/org/cortex/terminal/pty/PtyProcess.kt - Native PTY
app/src/main/java/org/cortex/terminal/pty/PtyNative.kt - Terminal emulator
app/src/main/java/org/cortex/terminal/emulator/TerminalEmulator.kt - Screen and scrollback
app/src/main/java/org/cortex/terminal/emulator/TerminalBuffer.kt - Terminal rows
app/src/main/java/org/cortex/terminal/emulator/TerminalRow.kt - Color schemes
app/src/main/java/org/cortex/terminal/emulator/TerminalColor.kt - Buffer search
app/src/main/java/org/cortex/terminal/emulator/TerminalSearch.kt - Key mapping
app/src/main/java/org/cortex/terminal/emulator/KeyMapper.kt
Ubuntu runtime
- Ubuntu bootstrap
app/src/main/java/org/cortex/terminal/runtime/BootstrapManager.kt - Runtime environment
app/src/main/java/org/cortex/terminal/runtime/Environment.kt - Runtime facade
app/src/main/java/org/cortex/terminal/runtime/CortexRuntime.kt - Userspace hook
app/src/main/cpp/cortex-hook.c
App services
- Foreground service
app/src/main/java/org/cortex/terminal/service/CortexService.kt - URL opener server
app/src/main/java/org/cortex/terminal/runtime/UrlOpenerServer.kt - App updater
app/src/main/java/org/cortex/terminal/update/UpdateManager.kt
Other components
- User
- Android Linux kernel
- Release and APK host
Connections 31
- User → Main activity: uses
README.md - Main activity → Foreground service: starts
app/src/main/java/org/cortex/terminal/MainActivity.kt - Main activity → Session manager: obtains
app/src/main/java/org/cortex/terminal/MainActivity.kt - Main activity → Terminal view: configures
app/src/main/java/org/cortex/terminal/MainActivity.kt - Main activity → Search bar: handles search
app/src/main/java/org/cortex/terminal/MainActivity.kt - Main activity → Virtual keys: configures
app/src/main/java/org/cortex/terminal/MainActivity.kt - Main activity → App updater: offers updates
app/src/main/java/org/cortex/terminal/MainActivity.kt - User → Settings: configures
app/src/main/java/org/cortex/terminal/SettingsActivity.kt - Session manager → Terminal session: creates
app/src/main/java/org/cortex/terminal/session/SessionManager.kt - Terminal session → PTY process: launches shell
app/src/main/java/org/cortex/terminal/session/TerminalSession.kt - PTY process → Native PTY: calls
app/src/main/java/org/cortex/terminal/pty/PtyProcess.kt - Native PTY → Android Linux kernel: creates PTY
README.md - Terminal session → Terminal emulator: feeds output
app/src/main/java/org/cortex/terminal/session/TerminalSession.kt - Terminal view → Terminal session: displays and writes
app/src/main/java/org/cortex/terminal/view/TerminalView.kt - Terminal emulator → Screen and scrollback: updates screen
app/src/main/java/org/cortex/terminal/emulator/TerminalEmulator.kt - Screen and scrollback → Terminal rows: stores rows
app/src/main/java/org/cortex/terminal/emulator/TerminalBuffer.kt - Screen and scrollback → Color schemes: uses colors
app/src/main/java/org/cortex/terminal/emulator/TerminalBuffer.kt - Terminal view → Buffer search: searches buffer
app/src/main/java/org/cortex/terminal/view/TerminalView.kt - Terminal view → Key mapping: maps input
app/src/main/java/org/cortex/terminal/view/TerminalView.kt - Runtime facade → Ubuntu bootstrap: delegates setup
app/src/main/java/org/cortex/terminal/runtime/CortexRuntime.kt - Ubuntu bootstrap → Runtime environment: uses paths
app/src/main/java/org/cortex/terminal/runtime/BootstrapManager.kt - Terminal session → Runtime environment: builds environment
app/src/main/java/org/cortex/terminal/session/TerminalSession.kt - Runtime environment → Userspace hook: sets preload
README.md - Userspace hook → Android Linux kernel: redirects userspace paths
README.md - Foreground service → Session manager: manages sessions
app/src/main/java/org/cortex/terminal/service/CortexService.kt - Foreground service → URL opener server: starts
app/src/main/java/org/cortex/terminal/service/CortexService.kt - App updater → Release and APK host: checks and downloads
app/src/main/java/org/cortex/terminal/update/UpdateManager.kt - User → App updater: requests update
README.md - User → Terminal view: searches scrollback
README.md - User → Terminal view: opens links and inserts images
README.md - User → Android Linux kernel: runs native programs
README.md