Lightcone Session

Manual step-by-step computer control via Lightcone sessions. Activate when user needs fine-grained browser or desktop automation, multi-step workflows, login sequences, or precise click-by-click interaction. Create a cloud computer, send actions, see screenshots.

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

Tool	Purpose
lightcone_session_create	Create a cloud computer (browser or desktop)
lightcone_session_action	Send actions (click, type, scroll, screenshot, etc.)
lightcone_session_close	Shut down the computer

Workflow Pattern

text

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

Parameter	Required	Description
url	No	URL to navigate to immediately
kind	No	"browser" (default) or "desktop"

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

lightcone_session_action

Parameter	Required	Description
sessionId	Yes	Session ID from create
action	Yes	One of the actions below
url	For navigate	Target URL
x, y	For click/scroll	Pixel coordinates
text	For type	Text to enter
keys	For hotkey	Comma-separated keys, e.g. "Control,c"
dx, dy	For scroll	Scroll deltas
seconds	For wait	Duration in seconds
command	For debug	Shell command to run

Actions

Action	Returns	Use for
screenshot	Screenshot	See current state
navigate	Screenshot	Go to a URL
click	Screenshot	Click at (x, y)
doubleClick	Screenshot	Double-click at (x, y)
rightClick	Screenshot	Right-click for context menu
type	Screenshot	Enter text at cursor
hotkey	Screenshot	Keyboard shortcut (e.g., Enter, Tab, Control+a)
scroll	Screenshot	Scroll at position
html	Page HTML	Extract page source
wait	Screenshot	Pause before next action
debug	Command output	Run shell command in the computer

Example: Login and extract data

text

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: "[e-mail]" }

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