Parallel coding agents, working to your plan.
Describe what you want in Claude Code and approve the plan. Agents build and review tasks in parallel. fold brings approved changes into your codebase, with progress and decisions in one live web interface.
curl -fsSL https://omukk.dev/fold/install.sh | sh Follow an email sign-in feature from plan to integration. As you scroll, the board shows what’s ready, running or waiting on review.
Backlog 0
Todo 0
In Progress 0
Review 0
Done 0
Plan
Run fld claude in your project and ask your Claude to add email sign-in. It clarifies the requirements before planning the work.
Plan
After your approval, your Claude creates four tasks and links their dependencies. The users table is ready in Todo; the other three wait in Backlog.
Build
The backend lead agent starts a worker on T-1. The worker builds the users table in its own task workspace.
Review
The worker submits its changes as a proposal. A reviewer agent inspects and tests it, fixes what the task’s scope settles, and sends larger changes back to the worker. Each approval belongs to the version reviewed.
Integrate
fold integrates the approved proposal into your project. T-2 now has what it needs, so it moves from Backlog to Todo automatically.
Build
Once the sign-in link is integrated, the sign-in page and rate limit are both ready. Frontend and backend workers can now build them at the same time.
Run tasks in parallel, review the changes and keep the decisions that need you in one place.
Give each task its own agent and workspace. Independent tasks run together; dependent tasks wait until their prerequisites are complete.
Reviewer agents inspect proposals, run checks and fix what the task’s scope settles. Product questions and larger changes go back to the author. Each approval belongs to the version reviewed.
fold integrates approved proposals in dependency order, once their prerequisites are complete. The project folder follows the integrated result.
fld push and fld pullApprove the plan before agents start. Questions, permissions and reviews that need your input come together in Needs you.
The board reflects the work as it happens. Follow agents, inspect proposals and revisit project history stored on your machine.
Manage sessions from your terminal. Follow progress, review changes and answer questions in your browser.
fld claudefld newfld pausefld resumefld recordfld stashfld unstash brings them backfld restartfld doctorGit is optional. Turn it on with fld init --with-git: an existing repository keeps its history, and every revision of main becomes a commit with your Git identity. Connect a remote to push and pull. fold pushes without force. If incoming changes conflict, it creates a sync task that goes through review.
fld init --with-git fld remote add origin <repository-url> [<branch>] fld push fld pull With Claude Code ready, set up fold in four steps.
curl -fsSL https://omukk.dev/fold/install.sh | sh Installs the fld command, which includes the web interface. Runs on Linux and Mac. To update, run it again, then fld restart.
fld init my-project Then cd my-project. Run fld init without a name to make the current folder a project. For an existing Git repository, commit or stash pending changes, check out a branch and run fld init --with-git from its root.
fld claude Tell the main agent what you want to build, the constraints and how you will check the result. It presents a plan for your approval, then starts the agents that build and review it.
127.0.0.1:7420 The board shows tasks across Backlog, Todo, In Progress, Review and Done. Needs you brings together questions, permissions, reviews and other items that need your decision.
Download a release binary, or build fold from source. Download a release (opens in a new tab) Build from source (opens in a new tab) See what changed in each release
We store only your email address and use it only for fold release news. Every email has an unsubscribe link.
Yes. fold is free and open source under the GNU AGPL v3.0 or later. It runs on your machine and uses your installed Claude Code.
fold uses your installed Claude Code. Sign in to Claude Code version 2.1.299 or newer before you start.
Yes. Run fld init in the project’s folder, then fld claude. For a Git repository, commit or stash pending changes, check out a branch, and run fld init --with-git from its root instead. The repository keeps its history.
No. Git is optional. To use it, install Git 2.36 or newer and run fld init --with-git. Every revision of main then becomes a commit with your Git identity, and fld push and fld pull exchange changes with your remote.
Yes. fold does not overwrite a file you changed, and agents do not see your changes until you record them. Run fld record to make your changes one revision of main. To put them aside instead, run fld stash, and fld unstash brings them back.
In .fold/ inside your project. Agents build in workspaces under .fold/ws/. The project folder holds the integrated result.
Run fld pause to stop the project’s workers and keep their sessions. Run fld resume to continue them later. Approved proposals can still integrate while workers are paused.
Run the install command again, then run fld restart so a running daemon uses the new version. To uninstall, run curl -fsSL https://omukk.dev/fold/install.sh | sh -s -- --uninstall. Each project’s .fold folder stays.
Report bugs through GitHub Issues. Include fld --version, your system and the steps to reproduce it; fld doctor can help identify setup problems. Report security vulnerabilities privately through the process in SECURITY.md. The repository is a read-only mirror, so send code patches by email; CONTRIBUTING.md explains how.