@nearform/fling 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 ## Unreleased
 
+## 0.5.0
+
+- **One MCP server for every Fling.** The local MCP server (`fling mcp` and the Claude Desktop
+  extension) knows every Fling the CLI remembers. Every tool that talks to a Fling takes an
+  optional `server` (an address, host or unique part of it), and calls use that Fling's own key.
+  An unknown or ambiguous `server` fails with the list of Flings.
+- **The server is chosen explicitly when there are several.** With one Fling (or none) nothing
+  changes: calls go to it. With several, the instructions and tool descriptions list them by host
+  and mark the current one, and tell Claude to settle at the start of a conversation which Fling it
+  uses (from your words, or by asking you, suggesting your current one), say so, and pass it as
+  `server` on every call. A call without `server`, reads included, doesn't run: it answers with the
+  list so Claude can ask. `fling mcp --server` and `FLING_URL` still pin one. The CLI's commands
+  are unchanged and follow `fling use`.
+- `fling_servers` lists the Flings on this computer (address, name, who is signed in, which is
+  current), read when called; `{use: <server>}` makes one current, as `fling use` does.
+- `fling_login` takes `server` to sign in to another Fling, including a new one. It becomes the
+  current Fling only when none is.
+- Deploy, publish and comment results end with the Fling they went to.
+- **One extension.** The extension has the same identity whichever Fling serves it, so installing
+  it from another Fling updates it in place. The address a Fling bakes in (`FLING_MCPB_SERVER_URL`
+  at build time, `FLING_ADD_SERVER` in the extension) is added to the remembered Flings when the
+  server starts, if it isn't there yet; it never replaces a stored key and becomes current only
+  when none is. The extension's **Fling server** setting is gone.
+- Upgrading: remove older Fling extensions from Claude Desktop (Settings → Extensions), then
+  install it once from any of your Flings. Earlier extensions were each tied to one Fling.
+
+## 0.4.0
+
+- **Several Flings.** The CLI remembers every Fling you sign in to, each with its own API key, and
+  uses the current one. `fling login <url>` and `fling setup <url>` add a Fling (or refresh its
+  login) and make it current without signing you out of the others. `fling use` lists them, with
+  each one's name and your email; `fling use <url>` switches (a full address, its host or the start
+  of it). `fling logout <url>` signs out of another Fling and forgets it; a bare `fling logout`
+  still removes the current Fling's key and keeps the Fling. `fling whoami` shows which Fling is
+  current.
+- `--server` and `FLING_URL` pick a remembered Fling for one command and use its stored key (an
+  address you haven't signed in to has no key; `FLING_API_KEY` still overrides). The local MCP
+  server uses the current Fling unless `FLING_URL` (the Claude Desktop extension's **Fling server**)
+  names one, and signing in from it makes that Fling current only when no other is.
+- Upgrading: `~/.fling/config.json` from 0.3 is read as-is, as one remembered Fling that is
+  current. It is rewritten in the new shape (`current` plus `servers`, keyed by address) the next
+  time the CLI saves it, so an older CLI can no longer read it after that.
+
 ## 0.3.0
 
 **Breaking: no default server.** The CLI works with any Fling deployment, so it no longer has one

package/README.md

@@ -35,6 +35,7 @@ This does everything a new machine needs:
 1. **Signs you in.** The CLI reads the server's `/.well-known/fling` (its name, where its sites
    live, how people sign in) and remembers it. Your browser opens for sign-in and an API key is
    stored in `~/.fling/config.json` (mode 0600). This is skipped if you're already signed in.
+   The server becomes your current one; logins to other Flings are kept.
 2. **Adds Fling to Claude Code.** If `claude` is on your PATH, setup installs the Fling plugin
    (skill + MCP server) from the `nearform/fling` marketplace, or updates it if it's already
    installed. `--scope project|local` installs it for this project only (default `user`).
@@ -45,8 +46,25 @@ On a terminal it asks before steps 2 and 3. With `--yes` it does them without as
 
 To sign in only, use `fling login <url>` (the URL is remembered: later `fling login` needs none).
 There is no default server: until you log in, commands say to run `fling login <url>`.
-`fling whoami` shows who you are, and `fling logout` removes the key (and keeps the server). For CI,
-set `FLING_URL` and `FLING_API_KEY` instead.
+`fling whoami` shows who you are and which server is current. For CI, set `FLING_URL` and
+`FLING_API_KEY` instead.
+
+### Several Flings
+
+The CLI remembers every Fling you sign in to, each with its own key, and uses the current one.
+`fling login <url>` or `fling setup <url>` adds a Fling (or signs in to it again) and makes it
+current; the others stay signed in.
+
+```sh
+fling use                              # list them: * marks the current one, with its name and your email
+fling use other.example.com            # switch: a full address, its host, or the start of it
+fling --server other.example.com ls    # one command against another Fling, with its own key
+```
+
+`FLING_URL` picks a Fling the same way for every command run with it, and `FLING_API_KEY`
+overrides the stored key. `fling logout` removes the current Fling's key and keeps it current (a
+bare `fling login` signs in again); `fling logout <url>` signs out of another Fling and forgets
+it.
 
 ## Deploy
 
@@ -186,10 +204,11 @@ feedback (`reviewUrl` in `--json`); reviewers sign in to use it.
 | `fling uncomment <name> <id> [--yes]` | delete a comment (a thread with its replies): your own, or any on your site |
 
 Global options: `--json` prints machine-readable output, and `--server <url>` points one command at
-another server. Exit codes are `0` ok, `1` error, `2` not logged in and `3` forbidden.
+another server (a remembered one brings its key; see [Several Flings](#several-flings)). Exit codes are `0` ok, `1` error, `2` not logged in and `3` forbidden.
 
 Environment: `FLING_API_KEY`, `FLING_URL`, `FLING_CONFIG_DIR`, `FLING_DEBUG`, `FLING_DOWNLOADS_DIR`
-(where the MCP server looks for files given by name first), `FLING_NO_WAIT=1` (after a deploy or a new share
+(where the MCP server looks for files given by name first), `FLING_ADD_SERVER` (a Fling the MCP
+server adds to the remembered ones when it starts), `FLING_NO_WAIT=1` (after a deploy or a new share
 link, don't wait the few seconds it takes to reach every edge).
 
 ## Claude Code plugin and MCP
@@ -209,8 +228,23 @@ Or install it by hand in Claude Code:
 ```
 
 Log in once with `fling login <url>` (or `npx @nearform/fling login <url>` if it is not installed).
-The MCP server reuses that login, and its tool descriptions name your Fling and where its sites
-live.
+The MCP server reuses your logins. It re-reads the config on every call, so a `fling login` or
+`fling use` in a terminal takes effect without a restart.
+
+**Several Flings.** The MCP server knows every Fling the CLI remembers, and every tool that talks to
+a Fling takes an optional `server`: its address, host or a unique part of it (as `fling use`
+accepts).
+
+- With one Fling (or none), calls go to it and `server` can be left out. The tool descriptions
+  name that Fling and where its sites live.
+- With several, the server is chosen explicitly. The instructions and descriptions list the Flings
+  by host and mark the current one. Claude settles which Fling the conversation uses at the start,
+  from your words ("on the other one", "on fling.example.com") or by asking you, with your current
+  Fling as the suggestion. It says which one it is using and passes it as `server` on every call,
+  switching only when you ask. A call without `server` (reads included) does not run: it answers
+  with the list of Flings so Claude can ask.
+- `fling mcp --server <url>` (or `FLING_URL`) pins the server: calls without `server` go there.
+- The CLI itself is unchanged: `fling use` and the current Fling govern CLI commands.
 
 The MCP tools:
 
@@ -221,9 +255,15 @@ The MCP tools:
 - `fling_find_files`: recent `.html`/`.zip` files and folders with an `index.html` in those folders,
   newest first (last 14 days by default).
 - `fling_login`: opens the browser sign-in. If you haven't finished after about 30 seconds it returns
-  and keeps waiting in the background for up to 5 minutes.
-- `fling_check_name`, `fling_list`, `fling_info`, `fling_share`, `fling_set_visibility`,
-  `fling_archive`, `fling_rollback`, `fling_delete` (needs `confirm: true`) and `fling_whoami`.
+  and keeps waiting in the background for up to 5 minutes. With `server` it signs in to another
+  Fling, including a new one, which becomes current only if none is.
+- `fling_servers`: lists the Flings on this computer (address, name, who is signed in, which is
+  current), read when called. `{use: <server>}` makes one current, the same as `fling use`.
+- `fling_check_name`, `fling_list`, `fling_info`, `fling_files`, `fling_share`,
+  `fling_set_visibility`, `fling_archive`, `fling_rollback`, `fling_delete` (needs
+  `confirm: true`), `fling_whoami`, and the comment tools when a Fling has comments.
+
+Results that give URLs (deploys, publishes, comments) end with the Fling they went to.
 
 The MCP server never prompts:
 
@@ -240,21 +280,27 @@ For Claude Desktop (including Cowork), install the one-click extension. It runs
 on your computer, so Claude can fling files you downloaded or that Claude Desktop saved, by name,
 without uploading anything from Claude's sandbox.
 
-1. Download `fling.mcpb` from your Fling (Get started → Download, or `https://<your Fling>/downloads/fling.mcpb`).
+1. Download `fling.mcpb` from any Fling (Get started → Download, or `https://<your Fling>/downloads/fling.mcpb`).
 2. Double-click it, or drag it into Claude Desktop, or go to **Settings → Extensions → Advanced
    settings → Install Extension…** and pick the file.
-3. Optional settings: **Fling server** (filled in with the Fling you downloaded it from; empty means
-   the one the CLI is logged in to) and **Downloads folder** (default `~/Downloads`).
+3. Optional setting: **Downloads folder** (default `~/Downloads`).
 4. Ask Claude to "fling Pitch Deck.html from my Downloads". If you're not signed in, Claude calls
-   `fling_login` and your browser opens. The extension and the CLI share the login in
+   `fling_login` and your browser opens. The extension and the CLI share the logins in
    `~/.fling/config.json`.
 
+There is one extension for every Fling. When it starts, it adds the Fling you downloaded it from to
+the ones this computer knows (if it isn't there yet) without changing the current one, unless none
+is current. Installing a copy from another Fling updates the same extension in place. To use
+another Fling, ask Claude to sign in to it (`fling_login` with its address) or run
+`fling login <url>`. With several Flings, Claude agrees with you which one to use, as described in
+[Several Flings](#claude-code-plugin-and-mcp) above.
+
 It needs Node.js 20 or later, which Claude Desktop provides, on macOS or Windows.
 
 Build it with `pnpm --filter ./apps/cli build:mcpb`. That bundles `src/mcp-entry.ts` and every
 dependency into one file, then validates and packs `mcpb/manifest.json` into `dist/fling.mcpb`
-(`FLING_MCPB_SERVER_URL` sets the **Fling server** default). A deploy publishes it at
-`/downloads/fling.mcpb`.
+(with `FLING_MCPB_SERVER_URL` set, its origin is baked into the extension's env as
+`FLING_ADD_SERVER`, the Fling added on start). A deploy publishes it at `/downloads/fling.mcpb`.
 
 To use the MCP server in another client, run it over stdio: