geelark-handle-change

name	geelark-handle-change
description	Change X/Twitter handles via GeeLark cloud phone automation. Use when you need to change an account's username, verify handle availability by attempting the change, or update handles across managed accounts.

GeeLark Handle Change Skill

Change X/Twitter account handles (usernames) using GeeLark cloud phone automation. The tool navigates to X's settings page on a cloud phone, types the new handle, waits for X's real-time validation, and taps Save.

When to Use This Skill

• Changing an X account's handle/username
• Checking if a handle is available (attempt the change; X validates in real-time)
• Updating handles for managed accounts after domain/brand decisions
• Rotating handles on warming accounts

Tool Discovery

search_tools({ query: "geelark_change_handle" })
search_tools({ query: "geelark_check_job" })

Available Tools

Tool	Purpose
geelark_change_handle	Start an async handle change job
geelark_check_job_status	Poll job progress/result

Usage

Change a Handle

// 1. Start the handle change (async job)
geelark_change_handle({
  phone_id: "phone-profile-id",
  account_id: "vault-account-uuid",
  new_handle: "mynewhandle",
  auto_stop: true  // optional, default true — stops phone after completion
})
// Returns: { job_id: "uuid", status: "running" }

// 2. Poll for completion (every 10-15 seconds)
geelark_check_job_status({ job_id: "uuid" })
// Returns: { status: "completed", result: { success: true, previousHandle: "oldname", newHandle: "mynewhandle" } }

Handle Taken

If the handle is already taken, X's real-time validation catches it before Save is tapped:

{
  "status": "completed",
  "result": {
    "success": false,
    "previousHandle": "oldname",
    "newHandle": "takenhandle",
    "error": "That username has been taken. Please choose another.",
    "errorCode": "handle_taken"
  }
}

Error Codes

Code	Meaning
handle_taken	Another account already has this handle
invalid_format	Handle contains invalid characters or wrong length (must be 4-15, alphanumeric + underscore)
rate_limited	X is rate-limiting handle changes (try again later)
save_failed	Save button tap didn't succeed
navigation_failed	Could not load the settings page
input_not_found	Could not find the username input field

Prerequisites

1. Phone must be running — start with geelark_start_phone if needed
2. Account must be logged in — the phone should have an active X session
3. Handle rules: 4-15 characters, letters/numbers/underscores only, no @ prefix needed

Vault Update

On success, the vault is automatically updated with the new handle. No manual vault operations needed.