Skip to content

v0.2.1

Choose a tag to compare

@github-actions github-actions released this 19 Oct 22:22
· 112 commits to main since this release

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 restart stops 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 -- --uninstall to uninstall fold. On a terminal, choose whether to remove fld and its service, fold's Claude Code configuration entries, and fold's settings and data. Without a terminal, the script removes only fld and its service. Each project's .fold folder 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 fld or 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 fld exists. 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 fld in ~/.local/bin. Set FOLD_VERSION to choose a release or FOLD_INSTALL_DIR to choose another folder.

  • After updating, run fld restart to 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.

Full changelog