frely-cli 0.6.2 → 0.6.6

package/README.md

@@ -1,21 +1,21 @@
 # frely-cli
 
-设计与 ChatGPT MCP 用户流程见 [`docs/chatgpt-mcp.md`](docs/chatgpt-mcp.md)。
+设备 MCP 的产品定义与通用客户端接入见 [`docs/device-mcp.md`](docs/device-mcp.md)。
 
-`frely-cli` is Frely's local command-line client, remote Agent bridge, and local MCP runtime. Remote Agent use and local tool sharing are separate flows.
+`frely-cli` includes FrelyMCP: let agents access your device from any location. Browser agents and command-line agents such as Codex and Claude Code use MCP to access the files, commands and processes on the computer you authorize. Invoking Frely-hosted Agents and sharing local model Providers are optional CLI features with their own setup and authorization.
 
 **Release boundary (checked 2026-09-17):** npm `frely-cli@latest` resolves to
-`0.6.1`. That published package includes local MCP and Provider commands but does
-not include `frely skill install` or `frely agent invoke`. Remote Agent examples
-below describe the source implementation and are not an onboarding path for that
-release. Check the installed version and published release before following them.
+`0.6.2`. The published tarball includes device MCP, Provider commands,
+`frely skill install` and `frely agent invoke`. Agent examples below apply to that
+release. Package contents establish command availability; service deployment,
+account or API-key access and client connections need their own verification.
 
 ```text
 Remote Agent Skill: install -> frely login -> frely skill install -> frely agent invoke
-Local tool sharing:  install -> frely login -> frely mcp setup -> add stable MCP URL -> OAuth authorize
+Device MCP:  install on target computer -> frely login -> frely mcp -> add MCP URL to client -> OAuth authorize
 ```
 
-`frely skill install` installs a local trigger Skill. It does not install a model or change the user's current model Provider/Base URL. `frely mcp setup` provisions local file, shell, process, and workspace execution; consuming a remote Frely Agent does not require that local execution authorization.
+`frely skill install` installs a local trigger Skill. It does not install a model or change the user's current model Provider/Base URL. `frely mcp` provisions local file, shell, process, and workspace execution; consuming a remote Frely Agent does not require that local execution authorization.
 
 There is no separate `friday-local` project. Local MCP execution belongs to `frely-cli`.
 
@@ -57,32 +57,57 @@ npm install --global frely-cli@0.3.6
 
 ## Update an existing installation
 
-If you installed `frely-cli` with the official installer, run the [Quick install](#quick-install) installer again. It replaces the global package with the latest `frely-cli` release. If you installed the package directly with npm, run one of the commands in [Install or update with npm](#install-or-update-with-npm) again.
-
-If multiple `frely` executables are installed, list the candidates and check the npm global installation:
-
-```sh
-type -a frely
-npm prefix --global
-"$(npm prefix --global)/bin/frely" --version
-```
-
-Your shell uses the first `frely` path in `PATH`. If that path is not the npm global bin directory, put `$(npm prefix --global)/bin` earlier in `PATH` and run `frely --version` again.
-
-If the background Device Relay service is running, restart it after the update so it loads the new CLI version:
-
-```sh
-frely mcp service stop
-frely mcp service start
-```
-
-Verify the update:
-
 ```sh
-frely --version
 frely doctor
+frely upgrade
 ```
 
+`doctor` reports the installation path, distribution and latest stable version.
+Release lookup has a timeout; offline version checks do not fail other diagnostics.
+Use `doctor --json` for structured results. `upgrade` has no options and never
+changes to a different installer, edits PATH or downgrades a newer installation.
+
+On macOS/Linux, `upgrade` updates the current standalone, npm-global or Bun-global
+installation. Standalone downloads are checksum-checked and tested before the
+installed executable is replaced. npm/Bun keep their original global directory
+and run with `--ignore-scripts`. Unknown installations, local links, source
+checkouts and temporary runners are left unchanged.
+
+A matching, running Device Relay service is paused for maintenance, restarted
+and checked after installation. Credentials, device identity, MCP URL, workspace
+and authorization expiry are preserved. Stopped or uninstalled services stay
+that way. If requests or managed processes are still running, the upgrade exits
+without stopping them. Finish those tasks and run the command in a local terminal;
+an upgrade invoked inside the MCP service being upgraded is itself active work.
+The connection may disconnect during the service restart. Installation, runtime
+version and Relay connectivity are reported separately.
+
+On Windows, `upgrade` prints a PowerShell command for the detected installation.
+Run it in a local terminal after finishing Frely tasks, then run `frely doctor`.
+The CLI does not launch an update helper or schedule a background replacement.
+
+For an already-running macOS/Linux service with automatic refresh support,
+updating the same installation with npm, Bun or the standalone installer also
+loads the new version without manual service commands. The service checks local
+installation files every five seconds, waits for two stable observations and
+checks that the new CLI starts. Active calls, managed processes and buffered
+responses defer the switch; calls remain available while work finishes.
+It uses the existing service supervisor and does not download updates itself.
+The MCP address, credentials, workspace and authorization expiry stay unchanged.
+
+A service that is stopped or not installed is never started by this watcher.
+Foreground sessions, source/link installs, changes of installation path and
+Windows replacement remain outside automatic refresh. A short reconnection
+window is possible; failed or outcome-unknown calls are not replayed.
+
+Versions predating the upgrade/refresh support require a one-time transition;
+see [service maintenance and legacy upgrades](docs/service-maintenance.md).
+Manual pause/resume commands remain in maintenance help.
+
+If more than one `frely` is installed, check the path shown by `doctor` before
+upgrading. The CLI does not remove other installations or choose one by changing
+shell configuration. See [the self-upgrade contract](docs/self-upgrade.md).
+
 ## Install from a local checkout
 
 To install the current source checkout with Bun:
@@ -124,12 +149,12 @@ Open the printed URL only in the browser signed in to the account you want to us
 
 `FRELY_NO_BROWSER=1` remains supported for scripts and existing setups. `frely login --help` lists the available options.
 
-### Remote Agent source preview
+### Invoke a Frely-hosted Agent
 
-The following Agent commands are not included in the verified npm release
-`0.6.1`; installing that version does not enable this workflow.
+The verified npm release `0.6.2` includes the Agent installation and invocation
+commands below. Use a published Agent with account or restricted API-key access.
 
-To install a published Frely Agent as a local trigger Skill from a supporting build:
+To install a published Frely Agent as a local trigger Skill:
 
 ```sh
 frely skill install https://app.frely.cloud/api/public/virtual-models/<distribution-id> \
@@ -158,17 +183,19 @@ printf '%s' 'Your complete task' | \
   frely agent invoke '<distribution-id>' --input-stdin --json
 ```
 
-### Local MCP connection
+### Device MCP: control this computer from a remote client
+
+Frely CLI turns the target computer into a personal device MCP service. ChatGPT in a browser, Claude Code on another computer, and other remote HTTP MCP clients with OAuth use the same endpoint. Install and run Frely CLI on the computer to control; the calling computer only needs its MCP client.
 
-For local workspace, file, shell, and process sharing, enable the separate local MCP runtime:
+Enable file, shell and process access on the target computer:
 
 ```sh
-frely mcp setup --workspace /path/to/project
+frely mcp --workspace /path/to/project
 ```
 
 `frely login` requests a restricted account session through browser device authorization. Basic sessions use private plaintext files, not the OS credential store. Legacy account cookies do not migrate to this store. Basic features and Network commands do not initialize MCP credentials.
 
-`frely mcp setup` initializes a separate secure MCP key, requests browser approval for this device and workspace, and installs the user-level Device Relay service. The default authorization is 90 days; `--days 1..180` selects a duration. `frely mcp renew --days 180` requires a new approval and rotates the MCP execution key. The MCP URL remains bound to the device. Login refresh, OAuth refresh, restart and repeated setup do not extend authorization.
+`frely mcp` initializes a separate secure MCP key, requests browser approval for this device and workspace, and installs the user-level Device Relay service. The default authorization is 90 days; `--days 1..180` selects a duration. `frely mcp renew --days 180` requires a new approval and rotates the MCP execution key. The MCP URL remains bound to the device. Login refresh, OAuth refresh, restart and repeated setup do not extend authorization.
 
 Services use macOS LaunchAgents, Linux systemd user units, or Windows Task Scheduler for the logged-on user. Windows implementation needs native acceptance testing. Linux MCP secure storage can require Secret Service or an injected key; basic installation does not.
 
@@ -178,20 +205,28 @@ You can print the URL again with:
 frely mcp url
 ```
 
+If MCP has not been configured, `frely mcp url` automatically runs the equivalent of `frely mcp setup --workspace ~`: it requests browser approval for your home directory (90 days by default), then installs the background service and prints the URL. Run `frely login` first. To select a project directory instead, run `frely mcp --workspace /path/to/project` before requesting the URL. Existing workspaces are preserved; expired authorization still requires `frely mcp renew`. Setup prompts go to stderr, so stdout remains a single URL or, with `--json`, a JSON object. No URL is printed if approval or service installation fails.
+
 Add the exact printed URL to a remote MCP client with OAuth support, choose
 OAuth and complete authorization. Keep the computer online. Ask the client to
 list the top-level names in your selected workspace, without writing files or
 running shell commands. A returned result that matches the folder verifies the
-first connection. `frely doctor` alone does not verify this path.
+first connection. `frely doctor` shows whether the running relay has a recent heartbeat; it does not complete client OAuth authorization or execute a tool through that client.
 
-If a call fails, check `frely doctor --mcp` and `frely mcp service status`.
+Use `frely doctor` for a quick overview. If a call fails, run `frely doctor -v` for detailed diagnostics.
 
-Or show ChatGPT-oriented connection details with:
+For Claude Code on the calling computer, replace the placeholder with the URL printed on the target computer:
 
 ```sh
-frely mcp chatgpt
+claude mcp add --transport http frely-computer "<MCP_URL>"
 ```
 
+Open `/mcp` in Claude Code to complete OAuth authorization. Use a distinct server name per device. Ask the Agent to use Frely tools for remote work; its built-in shell still runs on the calling computer. Clients of the same device share its workspace and managed processes. Unknown-outcome writes must not be replayed.
+
+Manage your devices in Frely → **Device MCP** (`/user/account/connections`). The page shows execution permission and connection history, not a live online indicator. Client OAuth authorization and device execution permission have separate lifecycles.
+
+`frely mcp setup` and `frely mcp chatgpt` remain compatibility aliases. The latter prints the same connection details; it does not create a ChatGPT-specific service. A bare `frely mcp` uses the current directory.
+
 ## Local model sharing
 
 `frely-cli` can publish a loopback OpenAI-compatible runtime as a Frely personal Provider. Ollama is the default driver.
@@ -225,14 +260,18 @@ frely provider finalize <provider-id>
 
 `finalize` resumes CPA setup for a Provider left in a prepared state.
 
+## Frely Cloud
+
+Use `frely cloud` to discover and call cloud business operations. See [Cloud commands and authorization](docs/cloud.md).
+
 ## Commands
 
 ```text
 frely login [--relay <https-url>] [--no-browser]
 frely logout
 frely whoami
-frely status [--json]
-frely doctor [--json]
+frely doctor [-v] [--json]
+frely upgrade
 frely skill install <manifest-url> [--host chatgpt|codex|claude-code|pi|generic] [--scope global|project] [--api-key-stdin] [--json]
 frely skill status <distribution-id> [--json]
 frely skill remove <distribution-id> [--json]
@@ -240,12 +279,11 @@ frely agent invoke <distribution-id> (--input <text>|--input-stdin) [--json]
 frely provider share [ollama|openai-compatible] [--url <loopback-v1-url>] [--models <a,b>] [--slot <slot-id>] [--name <name>]
 frely provider list [--json]
 frely provider finalize <provider-id>
-frely mcp setup [--workspace <path>]
+frely mcp [--workspace <path>] [--days 1..180]
+frely mcp renew [--days 1..180]
 frely mcp url [--json]
-frely mcp status [--json]
-frely mcp chatgpt
 frely mcp serve [--workspace <path>]
-frely mcp service status|start|stop|uninstall [--json]
+frely mcp service start|stop|uninstall
 frely mcp revoke
 frely mcp stdio [--workspace <path>]
 ```
@@ -273,7 +311,7 @@ Enrollment returns:
 ```
 
 The public MCP URL is the canonical resource returned by Relay, for example
-`https://mcp.frely.cloud/mcp/<device-id>`. Use `frely mcp url`; do not derive the URL
+`https://connect.frely.cloud/mcp/<device-id>`. Use `frely mcp url`; do not derive the URL
 from the control-plane hostname. The URL contains no bearer secret. Remote MCP clients use OAuth 2.1 Authorization Code + PKCE. OAuth access tokens bind to the exact MCP resource URL and do not extend the 90/180-day local execution authorization. Relay OAuth requirements are defined in [`docs/mcp-oauth-relay-contract.md`](docs/mcp-oauth-relay-contract.md).
 
 A Device Relay connection request uses the enrolled Ed25519 device key and returns a short-lived connection grant:
@@ -308,7 +346,31 @@ MCP secrets use AES-256-GCM files with a master key in macOS Keychain, Windows C
 
 The stable MCP URL contains no credential. Remote clients hold OAuth credentials; the CLI holds the MCP execution private key. The Relay checks OAuth resource binding and the current MCP execution lease. Expiry blocks requests and queued work and cancels managed execution. It does not undo writes or create a sandbox around arbitrary shell programs.
 
-`frely doctor` treats unconfigured MCP as optional. `frely doctor --mcp` checks the secure credential and server. `frely mcp status` displays local metadata; it is not server revocation proof.
+`frely doctor` is the single diagnostic entry point. It reports the installation
+path and distribution, checks the latest stable release with a deadline, and reads
+local account, MCP authorization, service and connection state. It does not access
+the MCP keyring in summary mode. An unavailable release source is informational;
+unconfigured account/MCP features remain optional.
+
+`frely doctor -v` (also `--verbose`) adds configuration paths, runtime details,
+service state, authorization expiry, last received heartbeat and sanitized last
+connection error. It also checks session storage, the account session and any
+configured MCP secure key/server authorization. Add `--json` to either view for
+structured output. Confirmed failures and unknown connectivity for a configured
+relay return a nonzero exit code.
+
+A running process is not proof of connectivity. Connected means the matching
+account/device process has received a WebSocket heartbeat within 75 seconds.
+The MCP authorization and workspace must also match the running relay. Missing,
+stale or old-runtime observations are reported as unknown. Verbose diagnostics
+include the running CLI version, entry path and start time. Diagnostics never
+restart the service or open a second relay connection. Neither mode claims
+to test client OAuth or an end-to-end tool call.
+
+Legacy `frely status`, `frely mcp status`, `frely mcp service status` and
+`frely doctor --mcp` remain compatible for existing scripts, but are no longer
+listed as recommended diagnostic entry points. The legacy status output shapes
+are unchanged; `doctor --mcp` requests verbose checks and requires MCP setup.
 
 Storage, migration, service injection, release requirements and threat boundaries: [`docs/credential-storage.md`](docs/credential-storage.md).
 
@@ -357,3 +419,8 @@ node dist/index.js network help --json
 ```
 
 CLI unit tests use a fake credential store and temporary home directories. They do not verify the user's OS credential-store permissions or a deployed Network.
+
+The planned unified MCP entry will support wallet-funded capability use without
+a Frely account. Current device MCP authorization and demo Network calls do not
+implement that complete flow. See [Wallet access plan](docs/mcp-wallet-access-plan.md)
+for the accepted product boundary and remaining work.

package/dist/agent-help.d.ts

@@ -1,4 +1,16 @@
 export declare const COMMANDS: readonly [{
+    readonly id: "cloud";
+    readonly usage: "frely cloud list|describe|call|login|logout [--help]";
+    readonly auth: "cloud-oauth";
+    readonly effect: "subcommand-dependent";
+    readonly purpose: "Discover and call Frely cloud business operations at app.frely.cloud/mcp. Use describe before call; parameters and results are JSON.";
+}, {
+    readonly id: "upgrade";
+    readonly usage: "frely upgrade";
+    readonly auth: "none";
+    readonly effect: "local-write";
+    readonly purpose: "Upgrade the current installation to the latest stable release. Windows prints a manual command; doctor checks versions.";
+}, {
     readonly id: "help";
     readonly usage: "frely help --agent --json";
     readonly auth: "none";
@@ -52,18 +64,12 @@ export declare const COMMANDS: readonly [{
     readonly auth: "account";
     readonly effect: "read";
     readonly purpose: "Read the signed-in account.";
-}, {
-    readonly id: "status";
-    readonly usage: "frely status [--json]";
-    readonly auth: "none";
-    readonly effect: "read";
-    readonly purpose: "Inspect CLI and authentication status.";
 }, {
     readonly id: "doctor";
-    readonly usage: "frely doctor [--mcp] [--json]";
+    readonly usage: "frely doctor [-v] [--json]";
     readonly auth: "optional-account";
     readonly effect: "diagnostic";
-    readonly purpose: "Check runtime and credential-store availability.";
+    readonly purpose: "Show installation, available upgrades, account, MCP and connection status; -v runs detailed diagnostics.";
 }, {
     readonly id: "provider.share";
     readonly usage: "frely provider share [ollama|openai-compatible] [--url <loopback-v1-url>] [--models <a,b>] [--slot <slot-id>] [--name <name>]";
@@ -84,34 +90,22 @@ export declare const COMMANDS: readonly [{
     readonly purpose: "Finish a prepared local Provider.";
 }, {
     readonly id: "mcp.setup";
-    readonly usage: "frely mcp [setup] [--workspace <path>] [--days 1..180]";
+    readonly usage: "frely mcp [--workspace <path>] [--days 1..180]";
     readonly auth: "account-and-browser";
     readonly effect: "authorization";
-    readonly purpose: "Authorize local tool execution and install its background service.";
+    readonly purpose: "Enable this computer as a device MCP service for remote HTTP MCP clients with OAuth; install its background service.";
 }, {
     readonly id: "mcp.renew";
     readonly usage: "frely mcp renew [--days 1..180]";
     readonly auth: "account-and-browser";
     readonly effect: "authorization";
-    readonly purpose: "Renew local MCP execution authorization.";
+    readonly purpose: "Renew this device's execution authorization without changing its MCP URL.";
 }, {
     readonly id: "mcp.url";
     readonly usage: "frely mcp url [--json]";
-    readonly auth: "mcp";
-    readonly effect: "read";
-    readonly purpose: "Read this device's MCP URL.";
-}, {
-    readonly id: "mcp.status";
-    readonly usage: "frely mcp status [--json]";
-    readonly auth: "none";
-    readonly effect: "read";
-    readonly purpose: "Inspect local MCP authorization metadata.";
-}, {
-    readonly id: "mcp.chatgpt";
-    readonly usage: "frely mcp chatgpt";
-    readonly auth: "mcp";
-    readonly effect: "read";
-    readonly purpose: "Read MCP connection details for ChatGPT.";
+    readonly auth: "account-and-mcp-or-browser";
+    readonly effect: "authorization-if-unconfigured";
+    readonly purpose: "Read this device's stable MCP URL. If unconfigured, set up the user home directory with browser approval and install the background service. --json includes HTTP transport and OAuth connection details; setup prompts go to stderr.";
 }, {
     readonly id: "mcp.serve";
     readonly usage: "frely mcp serve [--workspace <path>]";
@@ -120,16 +114,16 @@ export declare const COMMANDS: readonly [{
     readonly purpose: "Serve authorized local workspace tools.";
 }, {
     readonly id: "mcp.service";
-    readonly usage: "frely mcp service status|start|stop|uninstall [--json]";
+    readonly usage: "frely mcp service start|stop|uninstall";
     readonly auth: "none";
     readonly effect: "local-service";
-    readonly purpose: "Manage the local MCP background service.";
+    readonly purpose: "Pause, resume or remove the local MCP background service for maintenance. Supported upgrades restore running services without these commands.";
 }, {
     readonly id: "mcp.revoke";
     readonly usage: "frely mcp revoke";
     readonly auth: "account";
     readonly effect: "remote-write";
-    readonly purpose: "Revoke local MCP execution authorization.";
+    readonly purpose: "Revoke device MCP execution authorization for every connected client.";
 }, {
     readonly id: "mcp.stdio";
     readonly usage: "frely mcp stdio [--workspace <path>]";
@@ -150,6 +144,18 @@ export declare function agentHelp(): {
     skill_update_required: boolean;
     instructions: string[];
     commands: readonly [{
+        readonly id: "cloud";
+        readonly usage: "frely cloud list|describe|call|login|logout [--help]";
+        readonly auth: "cloud-oauth";
+        readonly effect: "subcommand-dependent";
+        readonly purpose: "Discover and call Frely cloud business operations at app.frely.cloud/mcp. Use describe before call; parameters and results are JSON.";
+    }, {
+        readonly id: "upgrade";
+        readonly usage: "frely upgrade";
+        readonly auth: "none";
+        readonly effect: "local-write";
+        readonly purpose: "Upgrade the current installation to the latest stable release. Windows prints a manual command; doctor checks versions.";
+    }, {
         readonly id: "help";
         readonly usage: "frely help --agent --json";
         readonly auth: "none";
@@ -203,18 +209,12 @@ export declare function agentHelp(): {
         readonly auth: "account";
         readonly effect: "read";
         readonly purpose: "Read the signed-in account.";
-    }, {
-        readonly id: "status";
-        readonly usage: "frely status [--json]";
-        readonly auth: "none";
-        readonly effect: "read";
-        readonly purpose: "Inspect CLI and authentication status.";
     }, {
         readonly id: "doctor";
-        readonly usage: "frely doctor [--mcp] [--json]";
+        readonly usage: "frely doctor [-v] [--json]";
         readonly auth: "optional-account";
         readonly effect: "diagnostic";
-        readonly purpose: "Check runtime and credential-store availability.";
+        readonly purpose: "Show installation, available upgrades, account, MCP and connection status; -v runs detailed diagnostics.";
     }, {
         readonly id: "provider.share";
         readonly usage: "frely provider share [ollama|openai-compatible] [--url <loopback-v1-url>] [--models <a,b>] [--slot <slot-id>] [--name <name>]";
@@ -235,34 +235,22 @@ export declare function agentHelp(): {
         readonly purpose: "Finish a prepared local Provider.";
     }, {
         readonly id: "mcp.setup";
-        readonly usage: "frely mcp [setup] [--workspace <path>] [--days 1..180]";
+        readonly usage: "frely mcp [--workspace <path>] [--days 1..180]";
         readonly auth: "account-and-browser";
         readonly effect: "authorization";
-        readonly purpose: "Authorize local tool execution and install its background service.";
+        readonly purpose: "Enable this computer as a device MCP service for remote HTTP MCP clients with OAuth; install its background service.";
     }, {
         readonly id: "mcp.renew";
         readonly usage: "frely mcp renew [--days 1..180]";
         readonly auth: "account-and-browser";
         readonly effect: "authorization";
-        readonly purpose: "Renew local MCP execution authorization.";
+        readonly purpose: "Renew this device's execution authorization without changing its MCP URL.";
     }, {
         readonly id: "mcp.url";
         readonly usage: "frely mcp url [--json]";
-        readonly auth: "mcp";
-        readonly effect: "read";
-        readonly purpose: "Read this device's MCP URL.";
-    }, {
-        readonly id: "mcp.status";
-        readonly usage: "frely mcp status [--json]";
-        readonly auth: "none";
-        readonly effect: "read";
-        readonly purpose: "Inspect local MCP authorization metadata.";
-    }, {
-        readonly id: "mcp.chatgpt";
-        readonly usage: "frely mcp chatgpt";
-        readonly auth: "mcp";
-        readonly effect: "read";
-        readonly purpose: "Read MCP connection details for ChatGPT.";
+        readonly auth: "account-and-mcp-or-browser";
+        readonly effect: "authorization-if-unconfigured";
+        readonly purpose: "Read this device's stable MCP URL. If unconfigured, set up the user home directory with browser approval and install the background service. --json includes HTTP transport and OAuth connection details; setup prompts go to stderr.";
     }, {
         readonly id: "mcp.serve";
         readonly usage: "frely mcp serve [--workspace <path>]";
@@ -271,16 +259,16 @@ export declare function agentHelp(): {
         readonly purpose: "Serve authorized local workspace tools.";
     }, {
         readonly id: "mcp.service";
-        readonly usage: "frely mcp service status|start|stop|uninstall [--json]";
+        readonly usage: "frely mcp service start|stop|uninstall";
         readonly auth: "none";
         readonly effect: "local-service";
-        readonly purpose: "Manage the local MCP background service.";
+        readonly purpose: "Pause, resume or remove the local MCP background service for maintenance. Supported upgrades restore running services without these commands.";
     }, {
         readonly id: "mcp.revoke";
         readonly usage: "frely mcp revoke";
         readonly auth: "account";
         readonly effect: "remote-write";
-        readonly purpose: "Revoke local MCP execution authorization.";
+        readonly purpose: "Revoke device MCP execution authorization for every connected client.";
     }, {
         readonly id: "mcp.stdio";
         readonly usage: "frely mcp stdio [--workspace <path>]";
@@ -296,3 +284,4 @@ export declare function agentHelp(): {
     }];
 };
 export declare function cliUsage(): string;
+export declare function mcpUsage(): string;

package/dist/agent-help.js

@@ -1,5 +1,7 @@
 import { VERSION } from "./version.js";
 export const COMMANDS = [
+    { id: "cloud", usage: "frely cloud list|describe|call|login|logout [--help]", auth: "cloud-oauth", effect: "subcommand-dependent", purpose: "Discover and call Frely cloud business operations at app.frely.cloud/mcp. Use describe before call; parameters and results are JSON." },
+    { id: "upgrade", usage: "frely upgrade", auth: "none", effect: "local-write", purpose: "Upgrade the current installation to the latest stable release. Windows prints a manual command; doctor checks versions." },
     { id: "help", usage: "frely help --agent --json", auth: "none", effect: "read", purpose: "Read this installed CLI's current Agent instructions." },
     { id: "key.budget", usage: "frely key budget (--api-key-stdin [--relay <url>]|--distribution <distribution-id>) [--json]", auth: "api-key", effect: "read", purpose: "Read the Key's self usage and each funding source's limits without account login." },
     { id: "skill.install", usage: "frely skill install <manifest-url> [--host chatgpt|codex|claude-code|pi|generic] [--scope global|project] [--api-key-stdin] [--json]", auth: "optional-api-key", effect: "local-write", purpose: "Install the public Agent's trigger Skill; an API key goes only through stdin to secure storage." },
@@ -9,19 +11,16 @@ export const COMMANDS = [
     { id: "login", usage: "frely login [--relay <url>] [--no-browser]", auth: "browser", effect: "authorization", purpose: "Authorize the CLI for the user's Frely account." },
     { id: "logout", usage: "frely logout", auth: "none", effect: "local-write", purpose: "Remove login and stop the MCP background service." },
     { id: "whoami", usage: "frely whoami", auth: "account", effect: "read", purpose: "Read the signed-in account." },
-    { id: "status", usage: "frely status [--json]", auth: "none", effect: "read", purpose: "Inspect CLI and authentication status." },
-    { id: "doctor", usage: "frely doctor [--mcp] [--json]", auth: "optional-account", effect: "diagnostic", purpose: "Check runtime and credential-store availability." },
+    { id: "doctor", usage: "frely doctor [-v] [--json]", auth: "optional-account", effect: "diagnostic", purpose: "Show installation, available upgrades, account, MCP and connection status; -v runs detailed diagnostics." },
     { id: "provider.share", usage: "frely provider share [ollama|openai-compatible] [--url <loopback-v1-url>] [--models <a,b>] [--slot <slot-id>] [--name <name>]", auth: "account", effect: "remote-write", purpose: "Publish a local model Provider." },
     { id: "provider.list", usage: "frely provider list [--json]", auth: "account", effect: "read", purpose: "List configured local Providers." },
     { id: "provider.finalize", usage: "frely provider finalize <provider-id>", auth: "account", effect: "remote-write", purpose: "Finish a prepared local Provider." },
-    { id: "mcp.setup", usage: "frely mcp [setup] [--workspace <path>] [--days 1..180]", auth: "account-and-browser", effect: "authorization", purpose: "Authorize local tool execution and install its background service." },
-    { id: "mcp.renew", usage: "frely mcp renew [--days 1..180]", auth: "account-and-browser", effect: "authorization", purpose: "Renew local MCP execution authorization." },
-    { id: "mcp.url", usage: "frely mcp url [--json]", auth: "mcp", effect: "read", purpose: "Read this device's MCP URL." },
-    { id: "mcp.status", usage: "frely mcp status [--json]", auth: "none", effect: "read", purpose: "Inspect local MCP authorization metadata." },
-    { id: "mcp.chatgpt", usage: "frely mcp chatgpt", auth: "mcp", effect: "read", purpose: "Read MCP connection details for ChatGPT." },
+    { id: "mcp.setup", usage: "frely mcp [--workspace <path>] [--days 1..180]", auth: "account-and-browser", effect: "authorization", purpose: "Enable this computer as a device MCP service for remote HTTP MCP clients with OAuth; install its background service." },
+    { id: "mcp.renew", usage: "frely mcp renew [--days 1..180]", auth: "account-and-browser", effect: "authorization", purpose: "Renew this device's execution authorization without changing its MCP URL." },
+    { id: "mcp.url", usage: "frely mcp url [--json]", auth: "account-and-mcp-or-browser", effect: "authorization-if-unconfigured", purpose: "Read this device's stable MCP URL. If unconfigured, set up the user home directory with browser approval and install the background service. --json includes HTTP transport and OAuth connection details; setup prompts go to stderr." },
     { id: "mcp.serve", usage: "frely mcp serve [--workspace <path>]", auth: "account-and-mcp", effect: "local-execution", purpose: "Serve authorized local workspace tools." },
-    { id: "mcp.service", usage: "frely mcp service status|start|stop|uninstall [--json]", auth: "none", effect: "local-service", purpose: "Manage the local MCP background service." },
-    { id: "mcp.revoke", usage: "frely mcp revoke", auth: "account", effect: "remote-write", purpose: "Revoke local MCP execution authorization." },
+    { id: "mcp.service", usage: "frely mcp service start|stop|uninstall", auth: "none", effect: "local-service", purpose: "Pause, resume or remove the local MCP background service for maintenance. Supported upgrades restore running services without these commands." },
+    { id: "mcp.revoke", usage: "frely mcp revoke", auth: "account", effect: "remote-write", purpose: "Revoke device MCP execution authorization for every connected client." },
     { id: "mcp.stdio", usage: "frely mcp stdio [--workspace <path>]", auth: "mcp", effect: "local-execution", purpose: "Serve authorized local tools over stdio." },
     { id: "network", usage: "frely network setup|status|find|use|logout [--json]", auth: "network", effect: "subcommand-dependent", purpose: "Access Frely Network using its separate setup and credentials." },
 ];
@@ -40,11 +39,26 @@ export function agentHelp() {
             "A Key amount limit is a spending cap. It reserves no funds and remains subject to its owner's available Plan allowance and Credit.",
             "Budget sources are independent constraints. Do not sum their remaining amounts or describe them as a Key balance.",
             "Installing a remote Agent Skill does not replace the host's current model provider.",
+            "Device MCP exposes this computer to remote HTTP MCP clients with OAuth. Commands execute on the device, not on the calling computer.",
+            "Use frely mcp to enable device MCP, frely mcp url for its address, and frely doctor [-v] for status and diagnostics.",
+            "If MCP is unconfigured, frely mcp url sets up the user home directory with browser approval. Existing workspaces and authorization expiry stay unchanged.",
+            "Remote clients of one device share its workspace and managed processes. Shell uses the device OS account; it is not a workspace sandbox.",
         ],
         commands: COMMANDS,
     };
 }
 export function cliUsage() {
-    return "Usage:\n" + COMMANDS.map((command) => "  " + command.usage + "\n").join("");
+    return "Usage:\n" + COMMANDS.filter((command) => command.id !== "mcp.service").map((command) => "  " + command.usage + "\n").join("") + "\nMaintenance (not required for supported upgrades):\n  frely mcp service start|stop|uninstall\n";
+}
+export function mcpUsage() {
+    return "Device MCP — use this computer from a remote MCP client.\n\nUsage:\n"
+        + COMMANDS.filter((command) => command.id.startsWith("mcp.") && command.id !== "mcp.service").map((command) => "  " + command.usage + "\n").join("")
+        + "\nMaintenance (not required for supported upgrades):\n  frely mcp service start|stop|uninstall\n"
+        + "\nStatus and diagnostics: frely doctor [-v] [--json]\n\n"
+        + "Run setup on the computer to control. Add its MCP URL to ChatGPT, Claude Code on another computer, or another HTTP MCP client, then authorize with OAuth.\n"
+        + "If MCP is unconfigured, frely mcp url runs setup for your home directory (~), waits for browser approval, then installs the background service. Setup prompts go to stderr; stdout contains only the URL or JSON.\n"
+        + "Existing workspaces are preserved. Expired authorization requires frely mcp renew.\n"
+        + "Clients share the device workspace and managed processes. Shell runs under the device OS account.\n"
+        + "Compatibility: frely mcp setup and frely mcp chatgpt remain available.\n";
 }
 //# sourceMappingURL=agent-help.js.map

package/dist/agent-help.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-help.js","sourceRoot":"","sources":["../src/agent-help.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-help.js","sourceRoot":"","sources":["../src/agent-help.ts"],"names":[],"mappings":"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"}

package/dist/cloud.d.ts

@@ -0,0 +1,7 @@
+export declare const CLOUD_USAGE = "Frely Cloud \u2014 call your Frely application.\n  frely cloud list [--group <name>]\n  frely cloud describe <tool>\n  frely cloud call <tool> [--json '<object>' | --input <file>]\n  frely cloud login\n  frely cloud logout\n\nResults are JSON. Cloud authorization is separate from device MCP.\nCalls may create resources or incur usage. Failed writes are never replayed automatically.\n";
+export declare function logoutCloud(): Promise<void>;
+export declare function runCloud(args: readonly string[]): Promise<{
+    value?: unknown;
+    text?: string;
+    failed?: boolean;
+}>;