Open and target your first repository

GDP is not a general filesystem browser. AI clients target repositories that you have already opened as GDP tabs, using the stable session-scoped repo_id instead of visual tab order.

Open the repository in GDP Desktop

Launch GDP Desktop.

Open or add the Git repository you want to work on.

Confirm the selected repository state in GDP Desktop.

Ask the connected AI client to list repositories before the first material change.

Use repo_id as the target identity

repo_id identifies an open GDP repository tab for the current app session. tab_index is only the visible ordering of tabs. If a repository closes, GDP rejects its old repo_id instead of silently pointing that identity at a different repository.

Prefer repo_id when more than one repository is open.

Re-list repositories after a tab closes or when target identity is uncertain.

Do not treat an arbitrary local path as a GDP target.

Why this boundary matters

Parallel conversations and tab switches are normal. Stable target identity prevents a request prepared for one repository from being silently redirected to another.