@pathmode/mcp-server 1.18.0 → 1.20.0

package/README.md

@@ -168,6 +168,25 @@ Works with Claude Code (`.mcp.json` in the project root), Claude Desktop (`claud
 
 Get your API key from **Settings > API Keys** in the [Pathmode app](https://pathmode.io).
 
+### Adopt an existing repository intent
+
+If your repository already contains a preflighted `intent.md`, start from the repo onboarding
+door in Pathmode. After you choose a workspace and Product, the page gives you a short-lived
+one-time command:
+
+```bash
+npx @pathmode/mcp-server@latest adopt pm_adopt_...
+```
+
+Run it from the repository root. The command uploads the existing spec, adds only Pathmode's
+canonical identity fields to its frontmatter, and configures that repository to use the selected
+workspace. The one-time code expires after 15 minutes and is never stored in the repository.
+
+The safe repository binding lives in `.pathmode/config.json`. The API key lives separately at
+`~/.pathmode/workspaces/<workspace-id>.json`, so connecting one repository does not repoint other
+repositories on the same machine. Add `.pathmode/` to `.gitignore` if your team does not want to
+commit the non-secret workspace binding.
+
 ### Local Mode (Offline)
 
 Local mode is the **default when no API key is configured**. It reads and writes [`intent.md`](https://intentspec.org/intent-md) in your
@@ -205,6 +224,7 @@ Pass `--local` only to force local mode when an API key *is* configured:
 | Method | Details |
 |--------|---------|
 | Environment variable | `PATHMODE_API_KEY=pm_live_...` |
+| Repository binding | `.pathmode/config.json`, with its key stored outside the repo in `~/.pathmode/workspaces/<workspace-id>.json` |
 | Config file | `~/.pathmode/config.json` with `apiKey`, `apiUrl`, `workspaceId` |
 | Local mode | Automatic when no key is found. Reads `intent.md` and `.pathmode/intents/*.md`; `--local` forces it |
 | No config | Local mode. The Intent Compiler needs no configuration |
@@ -299,7 +319,10 @@ The **Intent Compiler** works entirely offline — specs are saved to your proje
 
 **Keyless local mode sends nothing.** With no API key configured, the server makes no network request at all — no usage signals and no telemetry of any kind.
 
-**Data storage:** The MCP server does not store data locally (except `intent.md` files it creates and in `--local` mode). Persistent data is stored in Pathmode's cloud infrastructure.
+**Data storage:** The MCP server stores `intent.md` and, when a repository is adopted, a
+non-secret binding in `.pathmode/config.json` plus its API key in
+`~/.pathmode/workspaces/<workspace-id>.json`. The legacy `setup` command stores configuration in
+`~/.pathmode/config.json`. Persistent workspace data is stored in Pathmode's cloud infrastructure.
 
 **Third-party sharing:** No data is shared with third parties. The server communicates exclusively with the Pathmode API.