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
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
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: "user@example.com" }
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