friday-dev

Run your Friday agents on your own machine or VPS, powered by your local agent CLI (BYOA — Bring Your Own Agent). Friday always starts Claude Code with --dangerously-skip-permissions, using that computer's local tools, skills, and MCP configuration. Codex keeps its restricted default; other engines require an explicit host-access compatibility opt-in. Each agent gets its own workspace, memory, and skills. To dedicate one computer to each agent, pair the computers separately and assign them in Friday's agent editor.

Usage

Friday 0.18.12 shows the MCP servers and skills actually detected for each agent on its assigned computer. The editor shows the full installed catalog; team cards show only saved per-turn selections and use the same names and types. Empty configurations say that no per-turn requirements are set. Each MCP appears once, regardless of how many tools it provides; individual tool names, built-in tools, and shell commands are not new selectable requirements. Friday's own internal MCP is excluded.

Select installed capabilities in the agent editor:

• MCP: every turn must successfully call at least one appropriate tool from each selected MCP. The agent chooses which tool fits the task; it does not have to call every tool the MCP provides.
• Skill: read the selected skill's complete SKILL.md again before each work turn. Loading instructions does not require an unrelated tool invocation.

MCP and Skill remain distinct types, even if they have similar names. Up to 16 selections are supported in total. A recent report from this same agent, computer, engine, and provider must confirm availability. Disconnected MCPs, unreadable skills, and unverified items cannot be newly enabled. Existing unavailable selections can still be removed. New MCP selections require 0.18.12 support on the server, page, and daemon; earlier saved requirements retain their behavior and can be removed, but cannot be added as new choices.

The setting pins the agent to Claude Code while preserving its other tools, skills, MCP configuration, and existing permission mode. Calls must be appropriate for the task; do not invent arguments or make unrelated changes just to satisfy a requirement. A failed or missing invocation fails the turn explicitly, and results from previous turns do not count.

Refresh tools starts Claude and reads actual MCP lists and local skill sources without sending a user turn, requesting model generation, or executing browser or desktop tools. The UI waits for a new report and displays its check time; it reports a delay if none arrives within 60 seconds. Detection never satisfies a required MCP call. Refresh after installing, removing, or changing a capability. See required-tool behavior.

In 0.18.13, Computer Use's find_roots is discovery only and no longer counts as the required MCP call. The agent must observe or interact with the real app UI in that turn. For app tasks, Bash scripts and direct APIs are not a substitute for the requested UI work.

In Friday: You → Computers → Add a computer to get a pairing code, then on the machine you want to host agents:

npx friday-dev@latest agent computer --pair <code> [--server <your-server-url>]

Then start the daemon (after pairing, the config is saved):

npx friday-dev@latest agent computer [--server <your-server-url>]

--server is optional; it defaults to https://friday-server.preview.tencent-zeabur.cn. Pass it when you self-host.

Requires Node ≥ 18 and a supported CLI on your PATH. Claude Code uses native tools on macOS/Linux/WSL2/Windows. Codex's restricted mode requires Codex ≥ 0.138.0. The daemon talks to the Friday server over HTTPS only — it needs no database access. Claude's fixed permission flag also applies to background services, restarts, and diagnostics; old CUMORA_BYOA_ALLOW_UNSANDBOXED=0 service settings and whole-argument overrides cannot remove it. The environment switch still controls other engines. See BYOA documentation.

Persistent skills

Install shared Claude skills under ~/.claude/skills/, or agent-specific skills under ~/.cumora/agents/<agentId>/.claude/skills/. Friday preserves these files across restarts and package updates. Restart the service after installing or updating skills:

npx friday-dev@latest agent computer --restart

Skills provide instructions; tools such as ego lite or a desktop-control MCP must also be installed and configured on that computer. macOS permissions remain separate from Claude's permission flag.