Workspaces and Git

Every task has a workspace mode. The mode determines which files the agent sees and how you ship its changes.

Current checkout

Current checkout mode runs in the repository folder you selected. It behaves like a coding agent opened directly in that folder:

• it sees the branch and uncommitted files already present;
• it edits the same files your editor sees;
• Tellnova does not switch, stash, reset, commit, or clean the branch automatically;
• only one Tellnova task can use that checkout at a time.

When the task finishes, select the files to include and use Commit or Commit & push. Unselected changes remain in the working tree.

Your working tree remains yours

Start from a state you understand. Existing uncommitted changes are visible to the agent and may interact with its work.

Isolated worktree

Isolated mode creates a task branch in a separate Git worktree. Your original checkout is left alone, and multiple tasks can run in parallel.

The normal completion flow is:

1. Review the task’s changed files.
2. Push the task branch.
3. Open a pull request.
4. Merge it through the repository’s normal review process.

If the upstream repository is not writable, Tellnova can use your GitHub fork and open a pull request back to the upstream default branch.

Which mode should I choose?

Situation	Recommended mode
You are actively pairing with the agent in one folder	Current checkout
You want several tasks to run at once	Isolated worktree
The change needs review through a pull request	Isolated worktree
You need the agent to see local, uncommitted work	Current checkout
You are contributing through a fork	Isolated worktree