Run several sessions in one project without them getting in each other's way

When two agents work in the same folder, they edit the same files and trip over each other. A separate project copy fixes that: each session works in its own copy, and you decide what to take from it.

Step by step

1. Press ⌘N and pick a project.
2. Turn on “Separate copy of the project”. The switch appears if the project is already under Git and has at least one commit.
3. Click “Create”. A branch icon appears next to the session row.
4. Give the agent its task as usual.
5. When the work is ready, right-click the row and choose “Changes”. Or click the Git button with the file count in the toolbar.
6. Files are listed on one side, what changed on the other.
7. Click “Apply to project” to take the edits. Or “Discard all” to throw them away: the project stays as it was.

Split a task into parts

A large task can go to several sessions at once.

1. In the lead session, click ⚡ and choose “Split the task into parts”.
2. Finish the task text in the field and send it.
3. The lead splits the work into 2-4 parts that do not edit the same files, and writes a shared contract: names, API, structure.
4. For each part it starts a new session in its own project copy. The new rows appear in the sidebar.
5. Replies come back to the lead on their own. It checks the results and tells you what is ready.
6. You apply each part’s edits in the “Changes” window.

Good to know

• Git is required. If it is missing, Hedoq offers to install it with one click.
• Copies live outside the project folder, in ~/.hedoq/worktrees. Uninstalling Hedoq does not take them away.
• .env files from the project are copied into the copy.
• A regular session without a copy also has the “Changes” window, but only for viewing.
• If the project is linked to GitHub, the window may show a “Send to GitHub” button.
• Two sessions in the same folder without copies see the same changes. That is expected.

See also: sessions that talk to each other.