Skip to main content

Projects

A project associates a working directory with its agents and default roles. Use it to keep work aimed at the right repository and to give coding, review and coordination tasks suitable workers.

  1. Register the project from the project controls and choose its existing directory.
  2. Associate agents with it, using paths on the daemon host.
  3. Set the agent, backend/model and permission defaults for each role you use.
  4. Create a small task and check that its assignee and working directory match the project.

In the desktop app, use Browse… beside the working directory when creating or editing a project to choose a folder on your computer. Cancelling keeps the current path. In a web browser, enter the path manually.

Inspect project configuration from the CLI:

timon project list
timon project roles PROJECT_SLUG

To assign an existing agent to a role:

timon project set-role PROJECT_SLUG code PROJECT_AGENT

The project role is the normal default for a task; task-specific overrides are useful for exceptions. A project path is not a container path unless the daemon actually executes inside that container.

Git isolation​

A coding task's worktree has its own branch and files. The final merge integrates that branch into the chosen base. Check the task's worktree information before editing or integrating: sharing a project does not mean sharing one working directory.

Databases, credentials and services outside the repository remain shared. Coordinate changes to those resources separately from Git changes.