Make docs, images and copy match the product as it is today

.gitignore

@@ -22,3 +22,6 @@ scratch-*.ts
 *.sqlite-shm
 *.sqlite-wal
 config/oauth-app.json
+
+# Trying hosted mode locally (docs/hosting.md)
+.hosted/

AGENTS.md

@@ -1,6 +1,6 @@
 # Loopable
 
-Loopable puts your coding agent on a loop: workflows set up in the browser that run on the user's own machine. It is hosted at loop.goodone.si.
+Prompt it when you're here; loop it when you're not. Loopable turns the work that keeps coming back into agent workflows, set up in the browser at loop.goodone.si. They run on the user's own machine with Codex or Claude Code, and answer where they were asked.
 
 Work comes in from GitHub, Slack, Lark, email, or the clock. A loop says what to do. Codex, Claude Code, or Cursor Agent does it on a runner on the user's machine, and the answer is written back where it was asked. Every run is recorded. The story is in `docs/narrative.md`.
 
@@ -9,7 +9,7 @@ Work comes in from GitHub, Slack, Lark, email, or the clock. A loop says what to
 - TanStack Start (React + Vite) for the app, server routes and server functions
 - pnpm
 - Tailwind CSS with shadcn/ui
-- SQLite for state (libSQL when hosted), encrypted secrets when hosted, the OS keychain locally
+- SQLite for state (libSQL when hosted), encrypted secrets when hosted, the macOS keychain (or a file elsewhere) in `pnpm dev`
 - Hosted on Cloudflare: the app as a Worker, the dispatcher as a Container; see `docs/hosting.md`
 
 ## Workspaces

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 imsobear
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -2,7 +2,7 @@
 
 Prompt it when you're here. Loop it when you're not.
 
-Loopable turns the work that keeps coming back into agent workflows, in minutes. Set them up at [loop.goodone.si](https://loop.goodone.si); they run on your machine with Codex or Claude Code, and the answer goes back where it was asked.
+Loopable turns the work that keeps coming back into agent workflows, in minutes. Set them up at [loop.goodone.si](https://loop.goodone.si); they run on your machine with Codex or Claude Code, and answer where they were asked.
 
 A review request, a question in #oncall, a morning check: today each one waits until you copy it into your agent, and when you are busy or away, it stops. Hosted agents can take some of it, but they run in a cloud sandbox that cannot reach your internal network, logs, or services.
 
@@ -46,7 +46,7 @@ A loop’s answer can go to any connector that accepts it, so a scheduled check
 ## How it works
 
 <p align="center">
-  <img src="docs/architecture.svg" alt="Slack bot, GitHub, and Lark bot into Loopable. A runner pulls the job. Loopable writes back to the same three." width="920" />
+  <img src="docs/architecture.svg" alt="GitHub, Slack, Lark, Gmail and the clock start work in Loopable, which is hosted. A runner on your machine pulls the job and runs Codex or Claude Code. Loopable writes the answer back where it was asked." width="920" />
 </p>
 
 Loopable is hosted: the app and the dispatcher run on Cloudflare. The dispatcher watches your services, matches a loop, and queues the job. Your runner pulls it over HTTPS, runs the agent on your machine, and Loopable writes the answer back.
@@ -72,11 +72,11 @@ pnpm db:generate    # after changing src/server/db/schema.ts
 pnpm db:studio
 ```
 
-`pnpm dev` is a single local workspace with no sign-in. To try sign-in, workspaces, and joining a runner with a token locally, see [docs/hosting.md](docs/hosting.md#trying-hosted-mode-locally). `pnpm runner` is only for a second machine while `pnpm dev` is running.
+`pnpm dev` is a single local workspace with no sign-in. To try sign-in, workspaces, and joining a runner with a token locally, see [docs/hosting.md](docs/hosting.md#trying-hosted-mode-locally). `pnpm runner --token <from the local Runners page>` joins a second runner to `pnpm dev`, kept apart from your real one in `~/.loopable-dev`.
 
 ### Release and deploy
 
-Changes go through a pull request; CI must pass before it merges. Merging to `main` deploys the service by itself, migrations first. The CLI is released by hand with the **Release** workflow. All of it, and how to roll back, is in [docs/release.md](docs/release.md).
+Changes go through a pull request; CI must pass before it merges. Merging to `main` deploys the service by itself, migrations first. The CLI's version is bumped in a pull request with `pnpm bump`, then the **Release** workflow publishes it. All of it, and how to roll back, is in [docs/release.md](docs/release.md).
 
 | Path | Contents |
 | --- | --- |