scaledthought 0.3.2 → 0.3.4

package/README.md

@@ -1,13 +1,13 @@
 # scaledthought
 
-The CLI for [ScaledThought](https://scaledthought.com): headless, OpenAI-compatible inference for
-open-weight models, hosted in the US or Canada. It's built for coding agents: it never prompts, prints
+The CLI for [ScaledThought](https://scaledthought.com/go/org-npm): headless, OpenAI-compatible inference for
+open-weight models. The US region is live; Canada is coming soon. It's built for coding agents: it never prompts, prints
 JSON when stdout isn't a terminal, and every error is one JSON line on stderr with a non-zero exit.
 
 Agents: the full setup protocol is at <https://scaledthought.com/llms.txt>.
 
 ```bash
-npx -y scaledthought@0.3 init --region us   # or: --region ca (data stays in Canada)
+npx -y scaledthought@0.3 init --region us --source org-npm   # US only for now; Canada is coming soon
 ```
 
 `init` creates an account, writes `ST_API_KEY` and `ST_BASE_URL` to `./.env` (mode 0600), adds `.env` to
@@ -16,8 +16,17 @@ region, `next_command` and `next_steps`.
 Running it again is safe. If a key already exists it returns `"already_initialized": true` and the
 account status instead of creating a second account.
 
+Before `init`, ask your human one question: "What email should own this account?" and pass it as
+`--email <address>`. We email that address one confirmation link; once they click it they own the account and sign in
+to its dashboard (billing, credits, keys). We only send it account email, such as the confirmation, sign-in links and security
+notices, never marketing. `init` then prints `email_confirmation` and a `message_for_human` to relay. If they'd
+rather not, leave the flag out: `init` prints `"missing": ["owner_email"]`, and
+`npx -y scaledthought@0.3 account email set <address>` names them later.
+
 If you arrived through a `scaledthought.com/go/<code>` link, its instructions add `--source <code>` (a campaign code
-such as `a-rd`, stored on the new account so we know which campaign worked). It's optional, and a value that isn't a
+such as `a-rd`, stored on the new account so we know which campaign worked; the command above carries `org-npm`, the
+code for this page). Directory listings link to their own `/go/<code>`, and a listing's MCP URL can end in
+`?source=<code>`: connecting without a key then answers with the `init` command carrying that code. It's optional, and a value that isn't a
 code is dropped with a warning rather than failing `init`. On some US campaigns the human can copy an opt-in prompt
 ending in `(ad click <token>)`; the `/go` instructions then tell the agent to add `--ad-click <token>` (the token is
 in the prompt, never in the link). A malformed token is dropped with a warning, and the flag is ignored outside `us`.
@@ -43,7 +52,9 @@ ends, so the link would reach the human only after the payment it is waiting for
 npx -y scaledthought@0.3 models --live                 # models serving in your region now
 npx -y scaledthought@0.3 chat -m <id> "Reply with OK"  # one real completion (an id from models --live)
 npx -y scaledthought@0.3 mcp                           # `claude mcp add …` command + JSON config
-npx -y scaledthought@0.3 account                       # plan, region, spend
+npx -y scaledthought@0.3 account                       # plan, region, spend, owner_email
+npx -y scaledthought@0.3 account email set <address>   # your human's email owns the account once they confirm
+npx -y scaledthought@0.3 account rename "<name>"       # the account's name on the dashboard ("" = the default)
 npx -y scaledthought@0.3 account ad-measurement off    # opt out of ad measurement
 ```