monster-echo/CortexTerminal2

**Remote Terminals, Everywhere.**
简体中文
Corterm is a remote terminal platform. Install a lightweight Worker on any machine, deploy the Gateway, and access your terminals from any browser or mobile device -- your shell keeps running even after you close the tab.
Architecture
- **Gateway** -- Central server handling authentication, session routing, and real-time communication.
- **Worker** -- Lightweight agent that runs on your machines, manages PTY sessions, and streams I/O back to the Gateway.
- **Console** -- Browser-based terminal UI served by the Gateway. Also available as native iOS and Android apps.
> [!WARNING]
> The browser Console (src/Gateway/CortexTerminal.Console) is **no longer maintained**. Please use the Flutter (iOS / Android) or HarmonyOS clients.
Features
- **Browser-Native Terminal** -- Full xterm.js terminal with WebGL rendering. Works on desktop, tablet, and mobile.
- **Session Persistence** -- Detach and reattach at any time. Your shell keeps running. Previous output is replayed on reattach.
- **Multi-Worker** -- Connect and manage any number of remote machines from a single Gateway.
- **Mobile Access** -- Native iOS and Android apps with custom terminal keyboard, haptic feedback, and responsive layout.
- **AI Agent Tracking** -- Watch Claude Code work in real time. Claude Code hooks report every prompt, tool call, and notification to the Worker; the Console renders them as a structured timeline so you can monitor agents running on any worker.
- **File Transfer** -- Bidirectional file exchange between Console and Worker via S3-compatible storage. Drop a file in the Console and it lands in the shell's working directory; files written to $CORTERM_ARTIFACTS_DIR show up as downloadable bubbles.
- **Resource Monitoring** -- Live CPU and memory metrics for every worker, plus latency probes between client and worker.
- **Multiple Auth Methods** -- Password, phone SMS, GitHub OAuth, Google OAuth, and Apple Sign-In.
- **Worker Management** -- Monitor status, trigger remote upgrades, and run diagnostics (corterm doctor).
- **Admin Dashboard** -- User management, invitations, role-based access, and audit logging.
Quick Start
1. Deploy the Gateway
2. Install the Worker
**Linux / macOS:**
**Windows (PowerShell):**
3. Open Your Browser
Navigate to http://localhost:5045, log in, and start a terminal session.
Platform Support
**Worker:** Linux (amd64 / arm64) · macOS (Apple Silicon) · Windows x64 · Docker
**Client:** Any modern browser · iOS · Android
Mobile App Download
App Store
Google Play
AppGallery
Android APK
Tech Stack
.NET 10 (Gateway / Worker) · React 19 + xterm.js (Console) · Flutter (Mobile · Worker UI) · ArkTS (HarmonyOS) · SignalR + MessagePack
Running Tests
Unit tests run on every push via CI. Run them locally:
S3-compatible storage integration tests are opt-in (tagged Category=Integration). Boot MinIO locally and then run the filter:
The script uses Podman by default (Docker works too) and provisions a corterm-artifacts-test bucket separate from production. Override credentials via CORTERM_TEST_S3_* environment variables if needed.
Roadmap
- [x] **File Transfer** -- Bidirectional file exchange between Console and Worker via S3 presigned URLs (see below)