Your AI.
On your terms.
Bring remote agents, local tools, and your own models into one workflow. Right from your terminal.
Install Frely CLImacOS · Linux · Windows
$ frely login$ frely mcp setup --workspace .$ frely mcp url$ frely provider share ollama$ 01 / CONNECT YOUR WORKFLOW
One CLI.
Three ways to connect.
Choose what you need. Remote agents and local execution have separate setup flows.
LOCAL TOOLS / MCP
Your workspace,
within reach.
Connect a remote MCP client to local files, shell commands, and persistent processes. Approve your device and workspace in the browser, then add the stable MCP URL to your client.
frely login
frely mcp setup --workspace .
frely mcp urlLocal execution requires your approval. Shell commands run with your OS user’s permissions; the workspace is not a shell sandbox.
Read the MCP setup guideREMOTE AGENTS / SKILLS
More capabilities.
Your familiar host.
Install a published Frely Agent as a local trigger Skill for Codex, Claude Code, Pi, or another supported host. Keep your current model and provider configuration.
frely login
frely skill install <manifest-url> \
--host codex --scope global
frely agent invoke <distribution-id> \
--input "Your task"Replace the placeholders with a published Agent’s manifest URL and distribution ID. Remote Agent use does not require local MCP setup.
Read the Agent guideLOCAL MODELS / PROVIDERS
Your model.
A wider workspace.
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.
frely login
frely provider share ollama
frely provider listRequires a running local model and an empty, active personal Provider slot. Sharing a Provider does not enable local MCP execution.
Read the Provider guide02 / START HERE
A small install.
A new connection.
Install the CLI, sign in, then choose your workflow.
Prefer a standalone executable?Standalone releases include their runtime.
The npm package requires Node.js 22 or newer.
- 01
Install or update
npm install --global --ignore-scripts frely-cli@latest - 02
Sign in with your browser
frely login - 03
Check your setup
frely doctor
03 / OPEN BY DESIGN
Read it. Run it.
Make it better.
Frely CLI and this page are open source. Explore the code, report an issue, or contribute your next improvement.
The CLI connects to Frely’s hosted Relay service. The open-source client and local MCP runtime are licensed under Apache-2.0; Frely trademarks remain reserved.