From ea838b963e3f3cee7f8539c430cfa3bb2edcee51 Mon Sep 17 00:00:00 2001
From: badcuban <108198679+badcuban@users.noreply.github.com>
Date: Tue, 11 Aug 2026 11:25:23 -0400
Subject: [PATCH] Tell the README about onboarding, phone access, and the usage
 dashboard

The install warning claimed users must install and authenticate providers before use, which the first-run setup made false: it installs the CLIs with one click and signs in without leaving the app. The warning becomes a note saying so. Three Why bullets cover the features that arrived after the README was written: guided setup, phone pairing as a first-class client, and the cross-machine usage dashboard.
---
 README.md | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 2e6934e43..2314aa1e0 100644
--- a/README.md
+++ b/README.md
@@ -27,15 +27,21 @@ reconstructing context across tools.
   including their live state and stop controls.
 - **Durable, provider-flexible sessions.** Resume work after restarts and switch
   between Codex and Claude Code without losing the thread or working tree.
+- **Set up in minutes.** A first-run checklist installs the agent CLIs with one
+  click and signs you in without leaving the app.
+- **Your phone is a client.** Pair it with a QR code and check on running
+  threads from anywhere, against the desktop app or a self-hosted server.
+- **One usage picture across machines.** Token and cost dashboards read the
+  agents' own transcripts on every computer you run, merged into one view.
 
 ## Installation
 
-> [!WARNING]
-> Threadlines uses locally installed coding agents. Install and authenticate at
-> least one maintained provider before use:
->
-> - Codex: install [Codex CLI](https://developers.openai.com/codex/cli) and run `codex login`
-> - Claude: install [Claude Code](https://claude.com/product/claude-code) and run `claude auth login`
+> [!NOTE]
+> Threadlines drives locally installed coding agents:
+> [Codex CLI](https://developers.openai.com/codex/cli) and
+> [Claude Code](https://claude.com/product/claude-code). If they are missing,
+> the first-run setup installs them with one click and signs you in without
+> leaving the app. Installing them yourself beforehand works too.
 
 ### Desktop app