From 9ec2cf5048ae7a924ee9cb9c3950c41a627fae83 Mon Sep 17 00:00:00 2001
From: badcuban <108198679+badcuban@users.noreply.github.com>
Date: Tue, 11 Aug 2026 11:11:26 -0400
Subject: [PATCH] Bring the README and origins doc up to the product's present

Linux ships, the hosted web app and phone pairing are flagship features, and a Docker self-host door just opened, so the origins doc no longer describes remote surfaces as being phased out and no longer claims macOS and Windows only. Provider language softened from phased-out to actively-maintained-today with the door open for more. Origins framing keeps full T3 Code attribution while noting inspiration and contributions flow both ways. README gains the Docker quick start alongside the other install paths.
---
 README.md               | 34 +++++++++++++++++++++++++---------
 docs/fork-separation.md | 13 ++++++++-----
 2 files changed, 33 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index ad5a4c52e..2e6934e43 100644
--- a/README.md
+++ b/README.md
@@ -49,6 +49,22 @@ auto-updates is verified through the updater manifest hashes.
 
 Then open a local project and start a thread with the provider you already use.
 
+### Self-host with Docker
+
+Run Threadlines on a VPS or home server and connect from any browser or your
+phone:
+
+```bash
+docker run -d --name threadlines --restart unless-stopped \
+  -p 3773:3773 \
+  -v threadlines-home:/home/threadlines \
+  -v /path/to/your/repos:/workspace \
+  ghcr.io/threadlines/threadlines:latest
+```
+
+See [docker/README.md](./docker/README.md) for the full guide, including phone
+pairing and safe remote access.
+
 ### Server CLI
 
 The npm package supports advanced CLI/server and remote-bootstrap usage:
@@ -83,21 +99,21 @@ The artifact is written to `release/`.
 
 ## Supported providers
 
-Codex and Claude Code are the maintained provider paths. Other inherited
-provider surfaces may remain visible while Threadlines narrows toward a smaller
-native desktop surface, but they are not actively supported.
+Codex and Claude Code are the actively maintained providers today. Drivers for
+other agents exist in the codebase, and support for more providers is open for
+the future as the product grows.
 
 ## Origins
 
-Threadlines began as a fork of [T3 Code](https://github.com/pingdotgg/t3code).
-It now has its own product direction, branding, desktop release pipeline,
-provider orchestration, source-control workflow, signing/notarization setup, and
-compatibility policy.
+Threadlines began as a fork of [T3 Code](https://github.com/pingdotgg/t3code)
+and has since grown its own product direction, branding, release pipeline,
+provider orchestration, and source-control workflow. Upstream remains a source
+of inspiration, and improvements flow back when they fit.
 
 The upstream Git history and MIT attribution are kept intact.
 
-See [docs/fork-separation.md](./docs/fork-separation.md) for the current origin
-and compatibility policy.
+See [docs/fork-separation.md](./docs/fork-separation.md) for the origins and
+compatibility policy.
 
 ## Configuration
 
diff --git a/docs/fork-separation.md b/docs/fork-separation.md
index 73e555eec..93f78a69b 100644
--- a/docs/fork-separation.md
+++ b/docs/fork-separation.md
@@ -3,14 +3,17 @@
 Threadlines began as a fork of [T3 Code](https://github.com/pingdotgg/t3code).
 We keep that attribution and upstream history, while Threadlines owns the
 product direction, visible app identity, release lane, and compatibility policy.
+Upstream remains a source of inspiration, and improvements flow back where they
+fit.
 
 ## Current Direction
 
-- Threadlines is a local-first desktop app for macOS and Windows, focused on
-  Codex and Claude Code.
-- Codex and Claude are the maintained provider paths.
-- Remote, hosted-web, SSH, Tailscale, Cursor, and OpenCode surfaces are being
-  phased out unless they directly support the desktop workflow.
+- Threadlines is a workspace for coding agents that runs where you work: a
+  desktop app for macOS, Windows, and Linux, a self-hostable server (Docker,
+  VPS, homelab), a hosted web app, and phone access through device pairing.
+- Codex and Claude Code are the actively maintained providers. Drivers for
+  other agents remain in the codebase and support for more providers is open
+  for the future.
 - Compatibility should prevent old settings from disappearing during upgrades,
   but new user-facing guidance should use Threadlines names.