frelyCLI
OPEN SOURCE frely Skill · for agents with a shell

Frely CLI: give your agent
the Frely Skill

Paste one prompt into Claude Code, Codex or pi. The agent installs Frely CLI, signs you in with an email code and installs the frely Skill. With the Skill, your agent uses your Frely account, installs Skills and Agents from the Store, and sets up FrelyMCP when a task needs another computer.

INSTALL THE FRELY SKILL

Paste this into your agent

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.

Or install it yourself

# macOS

curl -fsSL https://frely.cloud/install.sh | sh

# 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"

# Then, in any system

frely login --email <you@example.com>
frely skill install --host <claude-code|codex|pi|generic>
Package managers

Requires Node.js 22+. Then run frely login and frely skill install.

npm install --global --ignore-scripts frely-cli@latest
bun add --global frely-cli@latest
pnpm add --global frely-cli@latest
Download a standalone executable

Standalone installers include their runtime and do not need Node.js.

SKILL FOR AGENTS WITH A SHELL

One prompt.
Your agent knows Frely.

The frely Skill tells your agent how to use your Frely account through Frely CLI. It does not open this computer to remote clients; FrelyMCP does that, after you agree.

Hosts: claude-code · codex · pi · generic

frely skill install --host <claude-code|codex|pi|generic>
No shell? Use FrelyMCP

FRELYMCP · FOR CLIENTS WITHOUT A SHELL

Using web ChatGPT?
Add FrelyMCP.

Web ChatGPT and Claude cannot run a shell, so they cannot use the Skill. Add FrelyMCP as a connector. FrelyMCP is the path for working on another computer, driving a connected browser and using Cloud MCPs you bought.

Your device

Your approved workspace

  • Files
  • Shell commands
  • Managed processes

Frely CLI

Runs on this computer, receives tool calls and returns results.

Third-party chat app

ChatGPT · Claude on the web, and other clients with remote MCP support

“List the files changed recently in my workspace.”

  1. You send a message in the chat app.
  2. The agent calls Frely tools through MCP; Frely forwards the call to your device.
  3. Frely CLI runs it on this computer, and the result returns to the conversation.

Connect this computer to FrelyMCP

# macOS / Linux

curl -fsSL https://frely.cloud/start.sh | sh

# 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"

Need to check the connection? Run frely doctor on the controlled computer. Add -v for detailed diagnostics.

frely doctor
Remote MCP + OAuth for web clients Runs on your computer No public device ports Apache-2.0 licensed

CONNECT YOUR AGENT

Choose your client.
Access your device.

Add the device MCP in your client and complete OAuth authorization. Pick a common client below, or follow one of the two universal methods.

Add the fixed address https://mcp.frely.cloud/mcp. It is the same for every device on your account and contains no access token. Each calling client signs in with your Frely account through OAuth.

Client names and logos belong to their respective owners and appear here only to indicate compatibility.

Option 1 · Paste the MCP URL

For clients such as ChatGPT that accept a pasted URL.

  1. Open your client's “Add MCP server / apps & connectors” settings.
  2. Paste the URL below and choose OAuth as the authentication method.
  3. Sign in with your Frely account in the browser to authorize.
https://mcp.frely.cloud/mcp
ChatGPT official guide

Option 2 · Paste a JSON config with a token

For clients such as WorkBuddy and Doubao Work that cannot run the OAuth sign-in and only accept a pasted MCP JSON config that carries a Bearer token.

  1. Open your Frely devices page. Under Controllers, choose Add device, then the “Copy JSON config (Bearer token)” tab.
  2. Generate the token, confirm with your passkey or authenticator code, and copy the config. The token is shown only once.
  3. Paste the copied config into the client's MCP settings (WorkBuddy: ~/.workbuddy/mcp.json) and save. No browser sign-in is needed.
Open the devices page

The sample shows the shape only. Use the config copied from the devices page, which contains your real token.

{
  "mcpServers": {
    "frely": {
      "url": "https://mcp.frely.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <token from the devices page>"
      },
      "disabled": false
    }
  }
}
WorkBuddy official MCP guide

Command-line agents

claude mcp add --transport http frelymcp "https://mcp.frely.cloud/mcp"
codex mcp add frelymcp --url "https://mcp.frely.cloud/mcp"

Ask the agent to use the Frely workspace_info and list_directory tools. Check that the returned folder and names match the target computer. The command-line agent's built-in shell runs on the calling computer.

Use frely doctor for configuration and connection status, or frely doctor -v for diagnostic details. A real tool result from the target computer verifies the client-to-device connection.

Clients of one device share its workspace and managed processes. File tools respect the workspace; shell commands run with the device OS account’s permissions, without a workspace sandbox.

Read the MCP setup guide

WHERE AGENTS CONNECT FROM

Agents in your browser.
Agents in your terminal.

Agents use MCP to access the computer you authorize. Frely forwards tool calls and returns execution results.

BROWSER AGENT → YOUR DEVICE

Give browser agents access to your device.

Add your device MCP URL in ChatGPT Web or another compatible client. Authorize access and ask the agent to inspect projects, edit files or run commands.

“Read this project’s README and summarize how to run it.”

COMMAND-LINE AGENT → YOUR DEVICE

Give command-line agents access to your device.

Use Codex, Claude Code or another command-line agent on a different computer to access the target computer's files, command-line tools and processes through MCP.

“Use the Frely tools to check the build on my workstation.”

Your agent sends the task. Your device runs it.

Files · Shell commands · Managed processes. Your device makes an outbound connection to Frely; no public listening port or router configuration is needed.

Set up device access

Requires a remote HTTP MCP client with OAuth support. Device permission and client authorization are separate. Keep the controlled computer running and online.

Commands run in a sandbox. See how it protects your data

OPTIONAL FEATURES

More uses for Frely CLI

Use local model sharing or invoke Frely-hosted Agents when you need them. Device access requires neither setup.

LOCAL MODELS / PROVIDERS

Share local models

Connect a running Ollama or another loopback OpenAI-compatible runtime as a personal Frely Provider. Use it through your existing Frely Access Points and API keys.

Requires a running local model and an empty, active personal Provider slot. Local MCP execution requires separate authorization.

Read the Provider guide

INVOKE FRELY-HOSTED AGENTS

Invoke Frely-hosted agents

Install a published Frely Agent as a trigger Skill in your client and invoke it through Frely CLI.

Authorize calls with your account or a restricted API key. Your client's model provider configuration stays in place; hosted Agent calls require no device execution permission.

Read the Agent invocation guide

OPEN SOURCE

Read it. Run it.
Contribute.

Frely CLI and this page are open source. Explore the code, report an issue, or contribute a change.

The CLI connects to Frely’s hosted Relay service. The open-source client and local MCP runtime are licensed under Apache-2.0; use of Frely trademarks is subject to the trademark policy.