Using Agent Browser to Fetch GitHub Starred Projects

Objective

Use the Agent Browser skill to log into GitHub and retrieve the starred projects of the currently logged-in user, sorted by the number of stars.

Execution Steps (Follow in Order)

1. Launch Browser and Open GitHub Homepage

   agent-browser --headed --profile "%HOMEPATH%\.agent-browser\chrome-win64\chrome-profiles\github" open https://github.com && agent-browser wait --load networkidle

2. Get Current Logged-in User Information

   agent-browser snapshot -i
   # Find the user avatar or username link in the top-right corner to confirm login status
   # Extract the username of the currently logged-in user from the page

3. Navigate to Current User's Stars Tab

   # Construct URL: https://github.com/{username}?tab=stars
   agent-browser open https://github.com/{username}?tab=stars && agent-browser wait --load networkidle

4. Sort by Stars Count (Most Stars First)

   agent-browser snapshot -i  # First get the latest snapshot to find the sort button
   agent-browser click @e_sort_button  # Click the sort button
   agent-browser wait --load networkidle
   # Select "Most stars" from the dropdown options

5. Retrieve and Record Project Information

   agent-browser snapshot -i
   # Extract project name, description, stars, and forks information

Critical Notes

1. Daemon Process Issues

• If you see "daemon already running", the browser is already running
• Important: When the daemon is already running, --headed and --profile parameters are ignored, and the browser continues in its current running mode
• You can proceed with subsequent commands without reopening
• To restart in headed mode, you must first execute: agent-browser close, then use the --headed parameter to reopen

2. Dynamic Nature of References

• Element references (@e1, @e2, etc.) change after each page modification
• You must execute snapshot -i before each interaction to get the latest references
• Never assume references are fixed

3. Command Execution Pattern

• Use && to chain multiple commands, avoiding repeated process launches
• Wait for page load after each command: wait --load networkidle

4. Login Status

• Use the --profile parameter to specify a profile directory, maintaining login state
• If login expires, manually log in once to save the state

5. Windows Environment Variable Expansion

• Important: On Windows, environment variables like %HOMEPATH% must be expanded to actual paths before use
• Incorrect: agent-browser --profile "%HOMEPATH%\.agent-browser\chrome-win64\chrome-profiles\github"
• Correct: First execute echo $HOME to get the actual path, then use the expanded path

  # Get HOME path (e.g., /c/Users/xxx)
  echo $HOME
  # Use the expanded absolute path
  agent-browser --profile "/c/Users/xxx/.agent-browser/chrome-win64/chrome-profiles/github" --headed open https://github.com

• Without expanding environment variables, you'll encounter connection errors (e.g., os error 10060)

6. Sorting Configuration

• Click the "Sort by: Recently starred" button (typically reference e44)
• Select the "Most stars" option
• Retrieve page content again

Troubleshooting Common Issues

Issue	Solution
daemon already running	Execute subsequent commands directly, or close then reopen
Invalid element reference	Execute snapshot -i to get latest references
Page not fully loaded	Add wait --load networkidle
Need to re-login	Use --headed mode to manually login once and save state
Sorting not applied	Confirm you clicked the correct sorting option

Result Output Format

• Project name and link
• Stars count (sorted in descending order)
• Forks count
• Project description (if available)