Docs/The board (Director)/Repositories
Director

Repositories and GitHub

3 min read

Agents work in repositories, so the Director keeps a catalog of yours. Open Session -> Repositories to see every repo under your root directories, launch sessions into them, clone new ones, and open them in Explorer or VS Code - one place instead of a folder hunt every time.

Screenshot coming soonThe Repository Manager with root directories on the left and the filterable repository list with Launch Session, Open Explorer, Open VS Code, Clone, and Delete Local actions
The Repository Manager with root directories on the left and the filterable repository list with Launch Session, Open Explorer, Open VS Code, Clone, and Delete Local actions

Root directories

A root directory is a folder you keep repos under (for example D:\Repos). The left pane lists yours; + Add opens a small dialog with a label, the folder path, and a provider - GitHub, Azure DevOps (with organization and project), or Local Only. The provider tells the Director where the repos come from, which powers cloning and status.

Working with the list

  • Launch Session (or double-click) - start an agent session in the selected repo. The rename dialog appears so the session starts life with a good name.
  • Open Explorer / Open VS Code - jump to the folder or the editor.
  • Delete Local - remove the local copy.
  • The filter box narrows a big list instantly; Refresh re-scans.

Cloning a repository

  1. Open Clone

    Select where it should go and hit Clone in the Repository Manager.

  2. Pick the source

    Paste a repository URL, or hit Browse GitHub to pick from your own GitHub repositories with a filter box - no URL copying needed.

  3. Clone and launch

    Choose the destination folder and clone. The repo appears in the list, ready for Launch Session.

Tip
Starting sessions from the Repository Manager keeps repo paths consistent - which matters, because session history and source control views are all keyed to the repo.
Note
Prefer the phone? The mobile app starts sessions from the same recent-repo list - see working with sessions from your phone.