Friday is an open-source coding-agent harness designed to coordinate several assistants on one computer. Its GitHub documentation lists support for Anthropic’s Claude Code, OpenAI’s Codex, Cursor, Google’s Gemini CLI, GitHub Copilot and other tools. Agents can divide a job, exchange messages and continue one another’s work when a provider’s usage allowance runs out.
The project’s central distinction is coordination. Opening several coding assistants gives a developer multiple places to send prompts. Friday adds a shared task board, agent-to-agent messaging, optional isolated repository copies and a review workflow around those assistants.
The local version is free and MIT-licensed, and the project says it requires no Friday account or hosted control service. One qualification: these are documented capabilities, not independently measured results. This article analyzes the project’s published workflow; compatibility, handoff reliability and privacy claims have not been independently verified.
How Friday Turns Separate Assistants Into a Team
Friday works with coding tools already installed and signed in on the developer’s machine. Its README lists Claude Code, Codex, Cursor, GitHub Copilot, OpenCode, Gemini CLI, Devin, Junie, Kiro, Factory Droid, Grok Build, Cline, Kilo and Amp, alongside support for ACP-compatible agents.
A session can begin with one agent breaking a larger request into tasks. Other agents then pick up portions of the work. Friday’s documentation describes a shared board where progress and dependencies remain visible, plus direct messages between agents.
That messaging has a practical purpose. An assistant changing a function name can tell another assistant before it writes code against the old interface. An agent facing an ambiguous requirement can ask a question and receive an answer without making the developer relay it manually. Friday says those messages appear in a live feed.
The documented completion process also includes running tests and having another agent review finished work before a task counts as done. Separately, the developer gets a change set to inspect before keeping it. Friday supports comments on individual lines or ranges, which can be sent back to the agent for revision. These features are described in the official README.
I’d treat the task board and review gates as more important than the number of supported assistants. A larger agent roster is useful only if the work has clear boundaries and someone checks the combined result. Adding another assistant to a poorly specified task can create another interpretation of the same ambiguity.
An illustrative division might assign an API change to one agent, interface updates to another and tests to a third. That is a plausible use of Friday’s documented workflow, not a tested example or a promise that every repository can be split cleanly.
Separate Repository Copies Reduce Editing Collisions
Friday lets an agent added to a session work in its own copy of the repository. That gives parallel agents separate working files, addressing a basic problem with having several assistants edit the same checkout.
Two agents operating in one directory can interfere before Git ever enters the picture. One may read a file while another is rewriting it, or run tests against changes it did not make. Separate repository copies reduce that immediate interference.
They do not eliminate integration work.
| Workflow | What Happens During Editing | What Still Needs Attention |
|---|---|---|
| Several agents share one checkout | Agents can encounter one another’s in-progress edits | File collisions, changing test conditions and unclear ownership |
| Agents use separate repository copies | Each agent has an isolated working copy | Combining changes and checking that they work together |
| Tasks have clear boundaries and messaging | Agents can communicate interface changes and dependencies | Validating that their shared assumptions are correct |
The distinction between isolation and integration matters. Two changes can be valid in their separate copies yet disagree about a function signature, configuration format or database assumption. Even changes that combine without a textual conflict can produce incorrect behavior together.
My reading is that Friday’s repository isolation and messaging solve different layers of the problem. Isolation protects the editing process; messages help agents coordinate meaning. Tests and developer review still have to assess the integrated result.
The repository documentation also says sessions can target an existing branch or start a new one from another branch. Friday says it will not switch a folder with uncommitted work out from under the developer. Its Git interface supports staging by file or hunk, committing, pulling, pushing and opening pull requests, including stacked pull requests.
Those controls make the final review consequential. Small, understandable changes are easier to inspect than a large combined diff, regardless of how many agents produced them.
Usage-Limit Handoffs Preserve Work, Not Unlimited Capacity
Friday’s usage-limit feature targets developers who already move between AI products when one subscription reaches its allowance.
According to the README, Friday displays each tool’s remaining usage. Developers can choose an assistant for a task or let an Auto option choose based on the job and available usage. If one assistant runs out during a task, Friday says the task moves to another agent with the work completed so far.
The documented sequence is:
- An agent begins a task using its existing account or subscription.
- Friday tracks the tool’s remaining usage.
- When the limit is reached, Friday selects another agent positioned to continue.
- The successor receives the task and accumulated work instead of starting from an empty assignment.
The practical benefit is continuity across tools. It is not extra capacity from the provider that imposed the limit. Another eligible assistant still needs to be available, authenticated and able to continue under its own plan.
The README’s promise to carry work forward also should not be read as a guarantee that different assistants share identical internal state. The published description does not establish exactly which conversation details, intermediate reasoning or tool-specific session state survive every cross-tool handoff.
I’d plan a handoff around explicit artifacts: the task description, changed files, test results, unresolved questions and decisions already made. Those give the next assistant something inspectable to work from. A task that depends on assumptions buried in a long conversation is harder to transfer reliably.
There is also an economic limit to the feature. Friday’s documentation provides no comparative benchmark or cost study showing that multi-agent execution is cheaper or faster than one assistant. Parallel work and additional review can consume more usage. Its documented advantage is coordinating available tools and allowances, not proving a reduction in total cost.
Installing Friday Without a Hosted Control Service
Friday offers desktop downloads for Apple silicon Macs, Intel Macs, Windows and Linux. The terminal route requires Node.js 22 or newer and Git.
The README gives this command:
npx github:splashxmoon/friday
That command starts Friday from the GitHub project through npx; it is the documented installation route, not a command executed for this article.
Frequently Asked Questions
3 questions
1Does Friday Replace Claude Code or Codex?
No. Friday coordinates installed coding tools and uses their existing sign-ins and plans. It also offers an optional built-in agent that can use a configured model.
