{
  "markdown": "# NomadTerm Server\n\n## What Is This?\n\nNomadTerm is a secure remote PTY daemon for AI CLI tools (Claude Code, Codex, Copilot, Gemini). It runs on the machine where your AI sessions live and lets you monitor and control them from your phone or desktop.\n\n```\nMobile app ──WebSocket──► nomadterm daemon ◄── manages ── nomadterm-desktop (GUI)\n```\n\n- **Daemon** (`nomadterm`) — runs in the background, exposes a `/ws` endpoint, manages PTY sessions, streams output to your phone in real time\n- **Desktop GUI** (`nomadterm-desktop`) — optional Tauri app on your Linux desktop to manage repos, generate QR codes, and start/stop the daemon with one click\n\n---\n\n## Install (Linux — recommended)\n\nDownload both `.deb` files from the [latest release](../../releases/latest):\n\n| File | What it installs |\n|------|-----------------|\n| `nomadterm_X.Y.Z_amd64.deb` | `/usr/bin/nomadterm` + systemd service |\n| `nomadterm-desktop_X.Y.Z_amd64.deb` | `/usr/bin/nomadterm-desktop` (the Tauri GUI) |\n\n```bash\nsudo apt install ./nomadterm_X.Y.Z_amd64.deb\nsudo apt install ./nomadterm-desktop_X.Y.Z_amd64.deb\n```\n\nAfter installing both, **NomadTerm** appears in your Ubuntu app launcher. Open it to get started.\n\n> **Tip:** copy the `.deb` files to `/tmp/` before installing to avoid an apt sandbox warning:\n> ```bash\n> cp ~/Downloads/nomadterm*.deb /tmp/\n> sudo apt install /tmp/nomadterm_X.Y.Z_amd64.deb /tmp/nomadterm-desktop_X.Y.Z_amd64.deb\n> ```\n\n---\n\n## Usage\n\n### Option A — Desktop GUI (recommended for desktop Linux)\n\n1. Install both `.deb` packages above\n2. Open **NomadTerm** from your app launcher\n3. Click **+** to add a repo folder\n4. Click **Start** — the daemon starts and a QR code appears\n5. Scan the QR from the NomadTerm mobile app to connect\n\nThe GUI manages tokens, ports, and the daemon lifecycle automatically.\nWhen Tailscale is installed and active, it is preferred automatically so the\nsame QR code can work from outside your home network. Without Tailscale,\nNomadTerm falls back to LAN-only access.\n\n---\n\n### Option B — Headless daemon (servers, SSH, no display)\n\n```bash\nnomadterm --ws --bind-tailscale --port 7681\n```\n\nUseful flags:\n\n| Flag | Description |\n|------|-------------|\n| `--bind-tailscale` | bind to the Tailscale IP (falls back to LAN IP if unavailable) |\n| `--port <PORT>` | WebSocket port (default `7681`) |\n| `--no-tls` | disable TLS for local/trusted networks |\n| `--token <TOKEN>` | set a fixed bearer token instead of generating one |\n| `--workspace <PATH>` | set the working directory for the session |\n\nAt startup the daemon prints the WebSocket address, bearer token, and a QR code. Scan it from the mobile app or enter the details manually.\nFor out-of-home access, keep Tailscale active on both the server machine and\nyour phone.\n\n#### Install as a systemd service\n\n```bash\n# First-time setup\nsudo bash install.sh init\n\n# Update later\nsudo bash install.sh update\n```\n\nThe `install.sh` script is included in `nomadterm-server-linux-x86_64.tar.gz` on the releases page, or downloadable directly:\n\n```bash\ncurl -Lo install.sh https://github.com/YOUR_ORG/nomadterm/releases/latest/download/install.sh\nsudo bash install.sh init\n```\n\n---\n\n## Connect from mobile\n\nOpen the NomadTerm mobile app and:\n\n- **Scan the QR code** shown by the daemon or desktop GUI, or\n- **Enter manually**: host, port, and token\n\nAfter connecting you can:\n\n- view and spawn AI CLI sessions (Claude Code, Codex, Copilot, Gemini)\n- open a live terminal view\n- approve or reject tool calls\n- kill a running session\n\n---\n\n## Build from source\n\n```bash\n# Daemon only\ncargo build --release\n./target/release/nomadterm --ws\n\n# Desktop GUI\ncd desktop\nnpm install\nnpm run tauri dev   # requires nomadterm binary in PATH\n```\n\n---\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 3745,
  "sha": "846eba67d86674d0b3e51d1a8b3dd1e1f6b40730df005097295f5a9243990d03",
  "repo_slug": "opentech-lab/nomadterm-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_opentech_lab_nomadterm_server_39d4c0dc/readme"
}