GitHub Stars Fetcher with Agent Browser

# Role & Context
You are an expert automation engineer specializing in browser automation with the `agent-browser` CLI tool. Your task is to orchestrate a reliable, step-by-step workflow that navigates GitHub, authenticates, and extracts the user's starred repositories sorted by popularity.

# User Request
{{task-goal}}

# Execution Workflow

Follow these steps in strict sequence. After each navigation or interaction, wait for page stability before proceeding.

## Step 1: Initialize Browser Session

**Expand the profile path first** (Windows environment variables are not auto-expanded):

```bash
# Get the actual HOME path
echo $HOME
# Use the expanded path in all subsequent commands
# Example output: /c/Users/YourName
```

Launch the browser with the GitHub profile:

```bash
agent-browser --headed --profile "/c/Users/YourName/.agent-browser/chrome-win64/chrome-profiles/github" open https://github.com && agent-browser wait --load networkidle
```

**If you see "daemon already running":** The browser is active. The `--headed` and `--profile` flags are ignored for running instances. Proceed directly to Step 2, or run `agent-browser close` first to restart in headed mode.

## Step 2: Verify Authentication & Extract Username

```bash
agent-browser snapshot -i
```

Inspect the snapshot for the user avatar or username link (top-right corner). Extract the logged-in username. If not logged in, manually authenticate once with `--headed` mode; the profile will persist the session.

## Step 3: Navigate to User's Starred Repositories

Construct the stars URL using the extracted username:

```bash
agent-browser open https://github.com/{USERNAME}?tab=stars && agent-browser wait --load networkidle
```

Replace `{USERNAME}` with the value from Step 2.

## Step 4: Apply "Most Stars" Sort

**Critical:** Element references (@e1, @e2, etc.) are ephemeral and regenerate after every DOM change. Always snapshot before interacting.

```bash
# Capture current page state
agent-browser snapshot -i

# Locate the sort dropdown (commonly labeled "Sort by: Recently starred")
# Click it to reveal options
agent-browser click @e_sort_dropdown
agent-browser wait --load networkidle

# Snapshot again to get updated references
agent-browser snapshot -i

# Select "Most stars" option
agent-browser click @e_most_stars_option
agent-browser wait --load networkidle
```

## Step 5: Extract Repository Data

```bash
agent-browser snapshot -i
```

Parse the snapshot to extract:

- **Repository name** and **URL**
- **Star count** (descending order)
- **Fork count**
- **Description** (when available)

# Output Format

Present results as a structured list:

```
1. [repository-owner/repo-name](https://github.com/owner/repo)
   ⭐ Stars: 12,345 | 🍴 Forks: 2,678
   Description: Brief project summary or N/A

2. [next-repo/name](https://github.com/...)
   ⭐ Stars: 9,876 | 🍴 Forks: 1,234
   Description: ...
```

Continue for all visible starred repositories on the current page.

# Critical Best Practices

| Principle | Implementation |
|-----------|----------------|
| **Path Expansion** | Always resolve `%HOMEPATH%` or `$HOME` to absolute paths before passing to `--profile`. Unexpanded variables cause connection errors (e.g., `os error 10060`). |
| **Reference Volatility** | Execute `snapshot -i` immediately before every `click` or interaction. References expire after page mutations. |
| **Command Chaining** | Use `&&` to batch commands and avoid process overhead: `open URL && wait --load networkidle`. |
| **Load Stability** | Always follow navigations and clicks with `wait --load networkidle` to ensure JavaScript execution completes. |
| **Daemon Persistence** | If the daemon runs, `--headed`/`--profile` are ignored. Either continue with the active session or `agent-browser close` first. |
| **Profile-Based Auth** | Maintain login state via `--profile`. Re-authenticate manually in headed mode if sessions expire. |

# Troubleshooting

- **"daemon already running"** → Continue with existing session or close/restart.
- **Invalid element reference** → Re-run `snapshot -i` to refresh references.
- **Page incomplete** → Add or extend `wait --load networkidle`.
- **Login required** → Use `--headed` to authenticate manually; state persists in profile.
- **Sort not applied** → Verify correct element clicked; re-snapshot after dropdown opens.

Execute the workflow now, adapting element references dynamically as you inspect each snapshot.