frely-cli 0.23.9 → 0.23.10

package/README.md

@@ -4,48 +4,42 @@
 
 [Website](https://cli.frely.cloud/) · [Docs](https://cli.frely.cloud/docs/) · [Frely](https://frely.cloud/) · [English](README.md) · [简体中文](README.zh-CN.md)
 
-Frely CLI (`frely-cli`) connects a computer you choose to **FrelyMCP**, so ChatGPT, Claude, Codex and other MCP clients can work on it from anywhere. They use the files, shell commands and processes in the folders you allow. The computer connects out to Frely, so you open no ports.
+Frely CLI (`frely-cli`) gives agents with a shell, such as Claude Code, Codex and pi, the `frely` Skill: your agent uses your Frely account and the Store from the terminal. For web ChatGPT and Claude, and to work on another computer, it connects a computer you choose to **FrelyMCP**, so those clients can use the files, shell commands and processes in the folders you allow. The computer connects out to Frely, so you open no ports.
 
 It is also the command line for your Frely account:
 
+- **Agents, Prompts and Skills**: install a published Frely Agent as a local Skill, or install Prompts and Skills you bought.
 - **Device MCP**: let remote AI clients work on this computer.
 - **Local MCP servers**: pass MCP servers that only run on this computer (for example on `127.0.0.1`) through to remote clients.
-- **Agents, Prompts and Skills**: install a published Frely Agent as a local Skill, or install Prompts and Skills you bought.
 - **Local model sharing**: publish a local Ollama or OpenAI-compatible runtime as your own Frely Provider.
 
 ## Install
 
-### A server, with a Frely account (no browser)
+### Let your agent set it up
 
-Get a one-time install command on the Frely website (**My Devices → Add a computer → Create install command**), or ask ChatGPT or Claude connected to FrelyMCP to add a computer. Paste it on the server:
+Ask an agent that has a shell (Claude Code, Codex, pi) to install the CLI, sign in and install the Skill:
 
-```sh
-curl -fsSL https://frely.cloud/start.sh | FRELY_INSTALL_TOKEN=fit_... sh
+```text
+Install Frely CLI and the frely Skill on this computer. On macOS or Linux run curl -fsSL https://frely.cloud/install.sh | sh; on Windows PowerShell run curl.exe -fsSLo "$env:TEMP\frely-install.ps1" https://frely.cloud/install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-install.ps1". Ask me for my email, run frely login --email <my email>, ask me for the 6-digit code from the email, then run frely login --code <code>. Then run frely skill install --host <your host: claude-code, codex, pi or generic> and read the Skill it installs. Do not run frely mcp start until I ask for it.
 ```
 
-It installs `frely`, signs in to your account, enables Device MCP and starts the background service. The token works once and expires after 15 minutes. On Linux, run `sudo loginctl enable-linger $USER` so the service stays online after you log out of SSH. [More](https://cli.frely.cloud/docs/help/install-on-a-server/)
+The `frely` Skill teaches the agent to use your account and to offer FrelyMCP only when a request needs it. This path does not open this computer to remote clients; `frely mcp start` does. [More](https://cli.frely.cloud/#skill)
+
+### Install it yourself
 
-### A computer with a browser
+`https://frely.cloud/install.sh` and `install.ps1` only install the program, for scripts and agents that need the CLI. Node.js 22 or newer is needed only for npm.
 
 ```sh
 # macOS / Linux
-curl -fsSL https://frely.cloud/start.sh | sh
+curl -fsSL https://frely.cloud/install.sh | sh
 ```
 
 ```powershell
 # Windows (PowerShell)
-curl.exe -fsSLo "$env:TEMP\frely-start.ps1" https://frely.cloud/start.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-start.ps1"
+curl.exe -fsSLo "$env:TEMP\frely-install.ps1" https://frely.cloud/install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-install.ps1"
 ```
 
-The script installs the latest `frely`, opens the browser to sign in (new accounts can register there), asks you to approve this device and prints your MCP URL. Run it again any time to update. The workspace is your home directory by default; set `FRELY_WORKSPACE=/path` to share another folder. [More](https://cli.frely.cloud/docs/help/how-do-i-install/)
-
-### Let your agent set it up
-
-Ask an agent that has a shell (Claude Code, Codex, pi) to install the CLI, sign in with `frely login --email`, and run `frely skill install --host <host>`. The `frely` Skill teaches the agent to use your account and to offer FrelyMCP only when a request needs it. This path does not open this computer to remote clients; `frely mcp start` does.
-
-### Install only
-
-`https://frely.cloud/install.sh` and `install.ps1` only install the program, for scripts and agents that need the CLI. Or use npm (Node.js 22 or newer):
+Or with npm:
 
 ```sh
 npm install --global --ignore-scripts frely-cli@latest
@@ -53,10 +47,18 @@ npm install --global --ignore-scripts frely-cli@latest
 
 The installers check the SHA-256 and download from GitHub Releases first, then npmmirror and npmjs. [More](https://cli.frely.cloud/docs/help/install-only/)
 
+Then sign in and install the Skill for your agent host:
+
+```sh
+frely login --email <you@example.com>   # then: frely login --code <6-digit code>
+frely skill install --host <claude-code|codex|pi|generic>
+```
+
 ## Common commands
 
 | Command | What it does |
 | --- | --- |
+| `frely skill install --host <host>` | Install the `frely` Skill for an agent host (`claude-code`, `codex`, `pi` or `generic`). |
 | `frely mcp start` | Sign in if needed, enable Device MCP, start the service and print the MCP URL. Safe to re-run. |
 | `frely mcp status` | Show the MCP URL, workspace, authorization expiry and service state. |
 | `frely mcp workspace add <path>` | Share another folder. `frely mcp workspace list` shows them all. |
@@ -65,7 +67,7 @@ The installers check the SHA-256 and download from GitHub Releases first, then n
 | `frely mcp remove` | Revoke access for every client and uninstall the service. |
 | `frely doctor` | Check sign-in, installation, service and connection. `-v` for details. |
 | `frely update` | Update to the latest version in place. |
-| `frely login` / `frely logout` | Sign in or out of your Frely account. |
+| `frely login` / `frely logout` | Sign in or out of your Frely account. `frely login --email <you@example.com>` then `--code <code>` signs in without a browser. |
 | `frely sandbox proxy <url>` | Forward the command sandbox's network traffic to your own HTTP(S) proxy. Without it the CLI uses `HTTPS_PROXY` / `HTTP_PROXY` / `ALL_PROXY` and, on macOS, the system proxy. `--clear` removes it; restart the service to apply. |
 | `frely tunnel <host>:<port>` | Inside a sandboxed command: listen on `127.0.0.1` and forward TCP connections to `host:port` through the sandbox, for database and redis clients. `--local-port N` picks the local port. |
 | `frely uninstall` | Remove Frely from this computer (lists everything first). |
@@ -74,8 +76,34 @@ All commands and options: [command reference](https://cli.frely.cloud/docs/help/
 
 ## Use with FrelyMCP
 
+Use FrelyMCP from clients with no shell, such as web ChatGPT and Claude, or to work on another computer.
+
 FrelyMCP is one MCP address for your whole account: `https://mcp.frely.cloud/mcp`. Every computer where you ran `frely mcp start` appears behind it.
 
+### Connect a computer with a browser
+
+```sh
+# macOS / Linux
+curl -fsSL https://frely.cloud/start.sh | sh
+```
+
+```powershell
+# Windows (PowerShell)
+curl.exe -fsSLo "$env:TEMP\frely-start.ps1" https://frely.cloud/start.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-start.ps1"
+```
+
+The script installs the latest `frely`, opens the browser to sign in (new accounts can register there), asks you to approve this device and prints your MCP URL. Run it again any time to update. The workspace is your home directory by default; set `FRELY_WORKSPACE=/path` to share another folder. [More](https://cli.frely.cloud/docs/help/how-do-i-install/)
+
+### Connect a server (no browser)
+
+Get a one-time install command on the Frely website (**My Devices → Add a computer → Create install command**), or ask ChatGPT or Claude connected to FrelyMCP to add a computer. Paste it on the server:
+
+```sh
+curl -fsSL https://frely.cloud/start.sh | FRELY_INSTALL_TOKEN=fit_... sh
+```
+
+It installs `frely`, signs in to your account, enables Device MCP and starts the background service. The token works once and expires after 15 minutes. On Linux, run `sudo loginctl enable-linger $USER` so the service stays online after you log out of SSH. [More](https://cli.frely.cloud/docs/help/install-on-a-server/)
+
 1. On the computer to control, run `frely mcp start` (the install scripts above already do this).
 2. Add the URL to your client as a remote MCP server with OAuth:
    - ChatGPT or Claude: add a custom connector with the URL.
@@ -90,6 +118,7 @@ To check the connection, ask the client to list the top-level names in your work
 
 ## More features
 
+- **Agents on this computer**: `frely agent local add <username/name>` downloads an Agent's repository into its own folder and `frely agent local start <name>` runs it inside the Frely sandbox. It can write only that folder, cannot read your SSH or cloud credentials, and never sees your Frely API key; its model calls go through a local proxy that adds the key. It can reach Frely's API and, after you approve each one once, the sites its `frely.yaml` lists. [Details](docs/agent-local.md)
 - **Frely-hosted Agents**: `frely item install <username/name> --host claude-code` installs an Agent as a local Skill; `frely agent run <username/name>` calls it. [More](https://cli.frely.cloud/docs/help/install-agents-and-items/)
 - **Marketplace Prompts and Skills**: `frely item install <username/name> --host claude-code` (the same command installs Agents too; add `@3` for version 3). Paid parts install only when your account holds a pass. `frely item update` lists installed items that have a newer version; it changes nothing until you run `frely item update <folder>`. [More](https://cli.frely.cloud/docs/help/install-agents-and-items/)
 - **Local model sharing**: `frely provider share ollama` publishes a loopback model server as your personal Frely Provider. [More](https://cli.frely.cloud/docs/help/share-local-model/)

package/README.zh-CN.md

@@ -4,48 +4,42 @@
 
 [官网](https://cli.frely.cloud/zh/) · [文档](https://cli.frely.cloud/docs/) · [Frely](https://frely.cloud/) · [English](README.md) · [简体中文](README.zh-CN.md)
 
-Frely CLI（`frely-cli`）把你指定的一台电脑连接到 **FrelyMCP**，让 ChatGPT、Claude、Codex 等 MCP 客户端可以在任何地方操作它，使用你授权的文件夹里的文件、Shell 命令和进程。电脑主动向 Frely 发起连接，不需要开放任何端口。
+Frely CLI 为 Claude Code、Codex、pi 等有 Shell 的 Agent 安装 `frely` Skill：你的 Agent 在终端使用你的 Frely 账号和 Store。对网页版 ChatGPT 和 Claude，或要操作另一台电脑时，它把你指定的一台电脑接入 **FrelyMCP**。
 
 它也是 Frely 账号的命令行工具：
 
+- **Agent、Prompt 与 Skill**：把已发布的 Frely Agent 安装为本地 Skill，或安装你购买的 Prompt 和 Skill。
 - **设备 MCP**：让远程 AI 客户端操作这台电脑。
 - **本机 MCP 服务**：把只在这台电脑上运行的 MCP 服务（例如监听 `127.0.0.1` 的）转给远程客户端使用。
-- **Agent、Prompt 与 Skill**：把已发布的 Frely Agent 安装为本地 Skill，或安装你购买的 Prompt 和 Skill。
 - **本地模型共享**：把本机 Ollama 或 OpenAI 兼容运行时发布为你自己的 Frely Provider。
 
 ## 安装
 
-### 服务器，已有 Frely 账号（无需浏览器）
+### 让 Agent 帮你安装
 
-在 Frely 网站 **My Devices → Add a computer → Create install command** 获取一次性安装命令，或让已连接 FrelyMCP 的 ChatGPT、Claude 添加一台电脑。粘贴到服务器上运行：
+让有 Shell 的 Agent（Claude Code、Codex、pi）安装 CLI、登录并安装 Skill：
 
-```sh
-curl -fsSL https://frely.cloud/start.sh | FRELY_INSTALL_TOKEN=fit_... sh
+```text
+在这台电脑上安装 Frely CLI 和 frely Skill。macOS 或 Linux 运行 curl -fsSL https://frely.cloud/install.sh | sh；Windows PowerShell 运行 curl.exe -fsSLo "$env:TEMP\frely-install.ps1" https://frely.cloud/install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-install.ps1"。向我询问我的邮箱，运行 frely login --email <my email>，再向我要邮件里的 6 位验证码，然后运行 frely login --code <code>。接着运行 frely skill install --host <your host: claude-code, codex, pi or generic>，并阅读它安装的 Skill。在我要求之前，不要运行 frely mcp start。
 ```
 
-它会安装 `frely`、登录你的账号、开启设备 MCP 并启动后台服务。令牌只能用一次，15 分钟内有效。Linux 上请运行 `sudo loginctl enable-linger $USER`，退出 SSH 后服务才能保持在线。[详情](https://cli.frely.cloud/docs/help/install-on-a-server/)
+安装的 `frely` Skill 会教 Agent 使用你的账号，只在需要时才建议 FrelyMCP。这种方式不会把这台电脑开放给远程客户端，`frely mcp start` 才会。[详情](https://cli.frely.cloud/zh/#skill)
+
+### 自己安装
 
-### 有浏览器的电脑
+`https://frely.cloud/install.sh` 和 `install.ps1` 只安装程序，供脚本和 Agent 使用。也可以用 npm（需要 Node.js 22 或更新版本）：
 
 ```sh
 # macOS / Linux
-curl -fsSL https://frely.cloud/start.sh | sh
+curl -fsSL https://frely.cloud/install.sh | sh
 ```
 
 ```powershell
 # Windows（PowerShell）
-curl.exe -fsSLo "$env:TEMP\frely-start.ps1" https://frely.cloud/start.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-start.ps1"
+curl.exe -fsSLo "$env:TEMP\frely-install.ps1" https://frely.cloud/install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-install.ps1"
 ```
 
-脚本安装最新版 `frely`，打开浏览器登录（新账号可在同一页面注册），请你批准这台设备，最后输出 MCP URL。随时可以再运行一次来升级。工作区默认是用户主目录，设置 `FRELY_WORKSPACE=/path` 可共享其他文件夹。[详情](https://cli.frely.cloud/docs/help/how-do-i-install/)
-
-### 让 Agent 帮你安装
-
-让有 Shell 的 Agent（Claude Code、Codex、pi）安装 CLI，用 `frely login --email` 登录，再运行 `frely skill install --host <host>`。安装的 `frely` Skill 会教 Agent 使用你的账号，只在需要时才建议 FrelyMCP。这种方式不会把这台电脑开放给远程客户端，`frely mcp start` 才会。
-
-### 只安装
-
-`https://frely.cloud/install.sh` 和 `install.ps1` 只安装程序，供脚本和 Agent 使用。也可以用 npm（需要 Node.js 22 或更新版本）：
+或用 npm：
 
 ```sh
 npm install --global --ignore-scripts frely-cli@latest
@@ -53,10 +47,18 @@ npm install --global --ignore-scripts frely-cli@latest
 
 安装器会校验 SHA-256，下载先走 GitHub Releases，再回退到 npmmirror 和 npmjs。[详情](https://cli.frely.cloud/docs/help/install-only/)
 
+然后登录并为你的 Agent 宿主安装 Skill：
+
+```sh
+frely login --email <you@example.com>   # 再运行：frely login --code <6 位验证码>
+frely skill install --host <claude-code|codex|pi|generic>
+```
+
 ## 常用命令
 
 | 命令 | 作用 |
 | --- | --- |
+| `frely skill install --host <host>` | 为 Agent 宿主（`claude-code`、`codex`、`pi` 或 `generic`）安装 `frely` Skill。 |
 | `frely mcp start` | 需要时登录，开启设备 MCP，启动服务并输出 MCP URL。可重复运行。 |
 | `frely mcp status` | 显示 MCP URL、工作区、授权到期时间和服务状态。 |
 | `frely mcp workspace add <path>` | 共享另一个文件夹。`frely mcp workspace list` 列出全部。 |
@@ -73,8 +75,34 @@ npm install --global --ignore-scripts frely-cli@latest
 
 ## 与 FrelyMCP 配合使用
 
+通过 FrelyMCP，让网页版 ChatGPT、Claude 等没有 Shell 的客户端使用 Frely，或操作另一台电脑。
+
 FrelyMCP 是整个账号共用的一个 MCP 地址：`https://mcp.frely.cloud/mcp`。每台运行过 `frely mcp start` 的电脑都在它后面。
 
+### 连接有浏览器的电脑
+
+```sh
+# macOS / Linux
+curl -fsSL https://frely.cloud/start.sh | sh
+```
+
+```powershell
+# Windows（PowerShell）
+curl.exe -fsSLo "$env:TEMP\frely-start.ps1" https://frely.cloud/start.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\frely-start.ps1"
+```
+
+脚本安装最新版 `frely`，打开浏览器登录（新账号可在同一页面注册），请你批准这台设备，最后输出 MCP URL。随时可以再运行一次来升级。工作区默认是用户主目录，设置 `FRELY_WORKSPACE=/path` 可共享其他文件夹。[详情](https://cli.frely.cloud/docs/help/how-do-i-install/)
+
+### 连接服务器（无需浏览器）
+
+在 Frely 网站 **My Devices → Add a computer → Create install command** 获取一次性安装命令，或让已连接 FrelyMCP 的 ChatGPT、Claude 添加一台电脑。粘贴到服务器上运行：
+
+```sh
+curl -fsSL https://frely.cloud/start.sh | FRELY_INSTALL_TOKEN=fit_... sh
+```
+
+它会安装 `frely`、登录你的账号、开启设备 MCP 并启动后台服务。令牌只能用一次，15 分钟内有效。Linux 上请运行 `sudo loginctl enable-linger $USER`，退出 SSH 后服务才能保持在线。[详情](https://cli.frely.cloud/docs/help/install-on-a-server/)
+
 1. 在要被控制的电脑上运行 `frely mcp start`（上面的安装脚本已经包含这一步）。
 2. 把 URL 作为使用 OAuth 的远程 MCP 服务加到客户端：
    - ChatGPT 或 Claude：用这个 URL 添加自定义连接器。

package/dist/agent/local/approvals.d.ts

@@ -0,0 +1,24 @@
+import { type Controller } from "../../controller/client.js";
+import { type LocalAgentRecord } from "./store.js";
+/** The shape of FrelyMCP's request_permission / permission_status answers that this file reads. */
+export interface ApprovalIo {
+    err(text: string): void;
+    /** A person is at the terminal and can be waited for. */
+    interactive: boolean;
+}
+export interface ApprovalDeps {
+    open?: () => Promise<Controller>;
+    deviceId?: () => Promise<string>;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+    pollMs?: number;
+    waitMs?: number;
+}
+/** The FrelyMCP resource name for one site. The relay shows it to the owner as "connect to <site>". */
+export declare const siteResource: (host: string) => string;
+/**
+ * Makes sure every site the Agent listed in frely.yaml is approved, asking the owner through the same approval link as any other
+ * device permission. Returns the approvals gained (site -> end time). A site the owner declines is left out and the Agent starts without it.
+ * Without a person at the terminal a pending request ends the command with exit code 3 and the link; run the command again after approving.
+ */
+export declare function approveSites(record: LocalAgentRecord, io: ApprovalIo, deps?: ApprovalDeps): Promise<Record<string, string>>;

package/dist/agent/local/approvals.js

@@ -0,0 +1,79 @@
+import { ensureDevice } from "../../device/control.js";
+import { openController, resultData, resultText } from "../../controller/client.js";
+import { ControllerError, EXIT } from "../../controller/session.js";
+import { approvedHosts } from "./store.js";
+const sleepFor = (ms) => new Promise((done) => setTimeout(done, ms));
+/** When the relay does not say, an approval is taken to last as long as its default window. */
+const DEFAULT_WINDOW_MS = 12 * 3_600_000;
+/** The FrelyMCP resource name for one site. The relay shows it to the owner as "connect to <site>". */
+export const siteResource = (host) => `net:${host}`;
+/**
+ * Makes sure every site the Agent listed in frely.yaml is approved, asking the owner through the same approval link as any other
+ * device permission. Returns the approvals gained (site -> end time). A site the owner declines is left out and the Agent starts without it.
+ * Without a person at the terminal a pending request ends the command with exit code 3 and the link; run the command again after approving.
+ */
+export async function approveSites(record, io, deps = {}) {
+    const now = deps.now ?? Date.now;
+    const open = deps.open ?? (() => openController({ interactive: io.interactive }));
+    const missing = record.network.filter((host) => !approvedHosts(record, now()).includes(host));
+    const gained = {};
+    if (missing.length === 0)
+        return gained;
+    const controller = await open();
+    try {
+        const device = await (deps.deviceId ?? (async () => (await ensureDevice()).deviceId))();
+        for (const host of missing) {
+            const end = await approveSite(controller, device, record, host, io, deps);
+            if (end)
+                gained[host] = end;
+        }
+    }
+    finally {
+        await controller.close().catch(() => undefined);
+    }
+    return gained;
+}
+async function approveSite(controller, device, record, host, io, deps) {
+    const now = deps.now ?? Date.now;
+    const sleep = deps.sleep ?? sleepFor;
+    const result = await controller.call("request_permission", {
+        device, resource: siteResource(host), mode: "window",
+        reason: `The local Agent ${record.slug} lists ${host} in its frely.yaml.`.slice(0, 300),
+        command: `frely agent local start ${record.slug}`,
+    });
+    const data = resultData(result);
+    if (result.isError === true || !data)
+        throw new ControllerError(`Could not ask for approval of ${host}: ${resultText(result) || "no answer"}`, EXIT.tool);
+    const status = data.status;
+    if (status === "allowed")
+        return typeof data.expiresAt === "string" ? data.expiresAt : new Date(now() + DEFAULT_WINDOW_MS).toISOString();
+    if (status === "not_needed")
+        return new Date(now() + DEFAULT_WINDOW_MS).toISOString();
+    const code = typeof data.shortCode === "string" ? data.shortCode : undefined;
+    const link = typeof data.approveUrl === "string" ? data.approveUrl : undefined;
+    if (status !== "pending" || !code)
+        throw new ControllerError(`Could not ask for approval of ${host}: ${resultText(result) || String(status)}`, EXIT.tool);
+    io.err(`${record.slug} wants to connect to ${host}. Approve it here (you choose how long): ${link ?? "Frely > Device MCP"}\n`);
+    if (!io.interactive) {
+        throw new ControllerError(`Approval needed for ${host}. Open the link above, approve it, then run the same command again.`, EXIT.approval);
+    }
+    io.err("Waiting for your decision…\n");
+    const deadline = now() + (deps.waitMs ?? 10 * 60_000);
+    for (;;) {
+        const answer = resultData(await controller.call("permission_status", { code }));
+        if (answer?.status === "approved")
+            return typeof answer.expiresAt === "string" ? answer.expiresAt : new Date(now() + DEFAULT_WINDOW_MS).toISOString();
+        if (answer?.status === "denied") {
+            io.err(`${host} was declined; ${record.slug} will run without it.\n`);
+            return undefined;
+        }
+        if (answer?.status === "expired" || answer?.status === "revoked") {
+            io.err(`The request for ${host} ended without an answer; ${record.slug} will run without it.\n`);
+            return undefined;
+        }
+        if (now() + (deps.pollMs ?? 3000) >= deadline)
+            throw new ControllerError(`Still waiting for approval of ${host}. Run the same command again to keep waiting.`, EXIT.approval);
+        await sleep(deps.pollMs ?? 3000);
+    }
+}
+//# sourceMappingURL=approvals.js.map

package/dist/agent/local/approvals.js.map

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

package/dist/agent/local/command.d.ts

@@ -0,0 +1,10 @@
+import { type ApprovalDeps } from "./approvals.js";
+export interface LocalIo {
+    out(text: string): void;
+    err(text: string): void;
+    interactive: boolean;
+    readSecret(): Promise<string>;
+}
+export declare const LOCAL_USAGE = "Usage:\n  frely agent local add <username/name | https://github.com/owner/repo> [--name <folder-name>]\n  frely agent local start <name> [--foreground]\n  frely agent local stop <name>\n  frely agent local logs <name> [--lines <n>] [--follow]\n  frely agent local list [--json]\n  frely agent local remove <name>\n  frely agent local key --api-key-stdin | --clear\n";
+/** Runs `frely agent local ...`; returns the exit code. */
+export declare function runAgentLocal(args: readonly string[], io: LocalIo, deps?: ApprovalDeps): Promise<number>;