Repository navigation
v0.2.1
fold 0.2.1
Run fld restart after an update to start the new daemon and resume workers in their saved sessions. This release also adds task area controls and an uninstaller.
Updates and restarts
fld restartstops the daemon cleanly and starts the installed version. It uses your systemd service or launchd agent when available, or starts the daemon in the background.- Workers can start and resume with fold tools after the installer replaces
fld, including while the daemon runs the previous version. - During a service stop, logout, or reboot, the systemd service lets the daemon stop its workers cleanly. Workers across all projects stop together and keep their sessions for the next start.
- Run
curl -fsSL https://omukk.dev/fold/install.sh | sh -s -- --uninstallto uninstall fold. On a terminal, choose whether to removefldand its service, fold's Claude Code configuration entries, and fold's settings and data. Without a terminal, the script removes onlyfldand its service. Each project's.foldfolder stays.
Task areas and labels
- The New task dialog includes an Area choice, with Let the main agent decide as the default. Add labels that do not represent areas in the Labels field.
- Task details have separate Area and Labels controls. Change the area in one operation, or add, create, and remove other labels.
- When the main agent assigns an area to a ready task, fold offers the task to that area's lead. If the area has no lead, the main agent receives it.
Improvements and fixes
- Agent chips in the top bar show worker state, including paused workers and failure reasons. Connected sessions show their presence.
- A worker that cannot find
fldor connect its fold tools at startup stops and appears in Needs you. fold notifies the main agent and the worker's starter. - Workers with these failures keep their claims while their leases remain valid. The next daemon start retries them once in their saved sessions, provided
fldexists. In a paused project, recovery waits until you resume it. - Resuming a worker waits for its previous process to exit, so two processes cannot run the same session.
Breaking changes
- A task can have at most one area label. Update integrations and agent commands that assign multiple area labels. Other labels have no limit. Tasks without an area wait for the main agent to choose one.
- Existing tasks with multiple area labels keep them and show an area conflict. You can edit their titles and descriptions, but a label update must leave at most one area label.
- Defining an area cannot give an existing, unarchived task a second area. Remove conflicting area labels from those tasks before defining the new area.
Install or upgrade
-
Install or update fold:
curl -fsSL https://omukk.dev/fold/install.sh | sh -
The installer puts
fldin~/.local/bin. SetFOLD_VERSIONto choose a release orFOLD_INSTALL_DIRto choose another folder. -
After updating, run
fld restartto use the new version. -
Binaries support Linux x86_64 and aarch64, and macOS 13 or newer on Apple silicon. Linux binaries are static. The web app comes with
fld. -
Use Claude Code 2.1.299 or newer and sign in before starting fold. Projects with Git require Git 2.36 or newer.