Lightcone Session Control

Three tools for manual step-by-step control of a cloud computer. Use when you need precise multi-step interaction with a website or desktop application.

For simple "go do this" tasks, prefer lightcone-browse (the /lightcone-browse command) instead.

Tools

Workflow Pattern

1. lightcone_session_create  → get session ID + initial screenshot
2. lightcone_session_action  → navigate, click, type, screenshot (repeat)
3. lightcone_session_close   → shut down

lightcone_session_create

Returns: session ID (e.g., lc-a1b2c3d4) + screenshot of initial state.

lightcone_session_action

Actions

Example: Login and extract data

Step 1: Create a cloud computer at the login page
  lightcone_session_create { url: "https://app.example.com/login" }

Step 2: Type username (click the email field first)
  lightcone_session_action { sessionId: "lc-...", action: "click", x: 640, y: 300 }
  lightcone_session_action { sessionId: "lc-...", action: "type", text: "[email protected]" }

Step 3: Type password
  lightcone_session_action { sessionId: "lc-...", action: "hotkey", keys: "Tab" }
  lightcone_session_action { sessionId: "lc-...", action: "type", text: "password123" }

Step 4: Submit
  lightcone_session_action { sessionId: "lc-...", action: "hotkey", keys: "Return" }
  lightcone_session_action { sessionId: "lc-...", action: "wait", seconds: 3 }

Step 5: Screenshot to verify login succeeded
  lightcone_session_action { sessionId: "lc-...", action: "screenshot" }

Step 6: Extract page content
  lightcone_session_action { sessionId: "lc-...", action: "html" }

Step 7: Shut down
  lightcone_session_close { sessionId: "lc-..." }

Tips

• Always take a screenshot after navigation to see the current state before clicking
• Use coordinates from the screenshot to target clicks accurately
• Wait 2-3 seconds after navigation or form submission for pages to load
• Use html action to extract structured data from the page
• Always close sessions when done to free resources