Projects and agents / 03

Projects and files

Open a project, add repository roots, browse files, and start agents in the selected project.

Open a project on the right host

Use the project-opening control on Home or in the project rail.
In the folder browser, choose the host that contains your code. The browser lists that host’s filesystem.
Navigate to the folder you want and choose Open Project Here.
Select the project in the rail. Open a new agent from that context so it works with the project’s roots.

For example, open ~/projects/garden on your home server. You can browse that project from your laptop without maintaining a second checkout on the laptop.

Add another root to a project

A project can contain more than one root. This is useful when one task spans an application repository and a related service repository. Choose + root in the file explorer header, then select the additional folder in the browser and choose Add Root.

Each Git root retains its own repository state. Check which root a change belongs to when staging, committing, or reviewing work. A multi-root project does not turn separate repositories into one repository.

Roots and workbenches. Tyde prevents changing the folders of a workbench, or of a parent project that currently has workbenches. Finish and remove those workbenches before reorganizing the parent’s roots.

Browse files and Git history

Select the project, then open Files in the sidebar.
Expand a root and its folders, then select a file to open it in a file tab.
Use the file explorer’s hidden-files control if the file is not shown. Right-click a folder to search within it.
Use Search to locate relevant code, or return to the conversation tab to ask the agent about a file.

For supported languages, code intelligence adds symbol information, navigation, and references. See Code intelligence for setup and language support.

The Git panel gives you a second way into the project: select a changed file to understand what is different. Use Recent commits to inspect work already committed.

Start a project agent

Begin with a request you can evaluate. Name the area of the project, describe the expected outcome, and tell the agent whether you want investigation or implementation.

Read this project and explain how the home page is assembled. Identify the files involved and suggest one small accessibility improvement. Wait for my decision before editing.

Follow the file references in the response. When you ask for a change, inspect the result in the Git panel and continue to Git changes and review comments.