How to Clone

1. Click the "Clone from GitHub" card on the Welcome Screen, or the Clone button on the Dashboard toolbar
2. You can also use the Command Palette (Cmd+K) and select "Clone Repository"

Authentication

If you haven't authenticated with GitHub yet, Pandev uses the GitHub Device Flow:

1. Click "Sign in with GitHub"
2. A device code appears (e.g., ABCD-1234) — it's automatically copied to your clipboard
3. Click "Open GitHub" to go to the verification page
4. Paste the code on GitHub and authorize Pandev
5. Pandev detects the authorization automatically (it polls in the background)

Once authenticated, your GitHub username and avatar appear at the top of the dialog. You stay authenticated across sessions.

Skip auth: If you just want to clone a public repo, click "or paste a URL manually" to skip authentication and enter the URL directly.

Selecting a Repository

After authentication:

1. Start typing in the Repository URL field — an autocomplete dropdown shows your repos (up to 20 results)
2. Each repo shows its name, description, language, and whether it's private
3. Use arrow keys to navigate, Enter to select, or paste a full URL
4. The Clone to path auto-fills based on the repo name (e.g., ~/Projects/my-repo)
5. Click Browse to choose a different destination folder

Cloning

Click "Clone" to start. A progress indicator shows the clone status. When complete:

• The repository is cloned to the specified path
• Pandev automatically adds it as a project
• The Project Setup Dialog appears for dev server configuration
• A toast notification confirms the project was added

Disconnecting

To disconnect your GitHub account, click the "Disconnect" button next to your username in the clone dialog. This removes the stored token.