FrelyMCP

Frely CLI

Website · Docs · Freely · English · 简体中文

Frely CLI (frely-cli) connects AI agents to your devices: remote computers, local servers, and shared models. For web ChatGPT and Claude, it connects computers you choose to FrelyMCP so those clients can use the files and commands in the folders you allow. For your own agents (Claude Code, Codex, pi), it lets them run and update Skills from the terminal.

Features and Installation

Want web ChatGPT or Claude to access your devices?

1. Add FreelyMCP to web agents
2. Install Freely CLI on your computer

Want AI agents to access local or remote devices?

1. Install Freely CLI on your computer

Want to share local models with friends?

1. Install Freely CLI on your computer
2. Local model sharing: frely service share model ollama publishes a local model server's models as your personal Freely Provider. Details

Step-by-Step Instructions

Install Freely CLI on your computer

A. Let your agent install Freely CLI

Ask an agent that has a shell (Claude Code, Codex, pi) to install the CLI, sign in and install the Skill:

Install Freely CLI and the frely Skill on this computer. First ask the user for their email, and whether they also want to allow remote control of this computer (for example from ChatGPT or Claude on the web). Then, using that email, run the installer for this operating system: on macOS or Linux run curl -fsSL https://frely.cloud/install.sh | sh -s -- --quiet --email <my email>; 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" -Quiet -Email <my email>. The installation emails me a 6-digit code: ask me for it, then run frely login --code <code> --host <your host: claude-code, codex, pi or generic> --quiet (add --link on if I agree to remote control; otherwise do not), and read the Skill it installs.

The installed frely Skill teaches the agent to use your account, and to suggest FreelyMCP only when a request needs it. This path does not expose this computer to remote clients; frely link on does. Details

B. Install Freely CLI manually

https://frely.cloud/install.sh and install.ps1 only install the program, for scripts and agents that need the CLI. You can also use npm (Node.js 22 or newer required):

# macOS / Linux

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

For agents: quiet output (details on failure only), sends the login code email right away

curl -fsSL https://frely.cloud/install.sh | sh -s -- --quiet --email you@example.com

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

Or with npm:

npm install --global --ignore-scripts frely-cli@latest

The installers verify SHA-256, download from GitHub Releases first, then fall back to npmmirror and npmjs. Details

Then sign in and install the Skill for your agent host:

frely login --email <you@example.com>   # Then run: frely login --code <6-digit code> [--host <host>] [--link on] (installs Skill; --link on also turns on remote control)

frely skill install --host

Add FreelyMCP to web agents

1. Find the connectors section in your settings, add a new connector/MCP
2. Name the connector anything, we recommend FreelyMCP
3. For the connector URL, enter https://freely.cloud/mcp
4. For authentication, select OAuth

If you don't have a Freely account, you'll be directed to the Freely login page, where you can create a new account using your email.

ChatGPT Tutorial

Tutorial https://freely.cloud/docs/chatgpt

Claude Tutorial

Tutorial https://freely.cloud/docs/claude

Common Commands

All commands and options: command reference. frely help --agent --json prints the full machine-readable contract.

Safety

File tools stay inside the shared workspaces and protect credential and shell start-up files. Commands run as your OS user inside an OS sandbox, and are refused where the computer cannot sandbox them. Clients hold OAuth tokens; the CLI keeps its own key in the system credential store. Is it safe? · Sandbox and permissions · Credential storage

Documentation

• Help: cli.frely.cloud/docs (update, doctor, uninstall)
• Contracts, for contributors: Device MCP · Device Relay transport · MCP OAuth contract · frely api · Freely Network (preview) · self-update · service maintenance

License and trademarks

frely-cli is licensed under the Apache License 2.0; see LICENSE. The Freely name, logos and product names are not licensed as trademarks; see TRADEMARKS.md. See CONTRIBUTING.md for development and SECURITY.md to report a vulnerability.