The
computer tool is the generally available integration and runs on the GPT-5.5 and GPT-5.6 families. The older computer_use_preview tool and its computer-use-preview model still work, and are covered at the end of this page. Use the GA tool for anything new.Coordinate space
Orgo computers boot at1280x720x24.
The computer tool takes no display size. The model reads the screen dimensions from the screenshots you send, and returns x and y in that same pixel space. Send an Orgo screenshot unresized and the coordinates come back as the computer’s pixels. Pass them straight to left_click.
Send "detail": "original" with each screenshot so the API keeps the resolution the model is measuring against.
GET /computers/{id}/screens reports the current width and height if you created the computer at another resolution or resized its screen later.
Quick start
1
Install packages
2
Set up API keys
3
Run your first task
Complete example
A full agent loop. The model returns a batch of actions per turn, so run every entry inactions[] in order before you screenshot.
Usage examples
Basic tasks
Complex workflows
Reusing sessions
Key concepts
The agent loop
- Request Send the task to the model.
- Actions The model returns a
computer_callholding a batch of actions. - Execute Your code runs every action in the batch, in order.
- Screenshot Capture the result and return it as a
computer_call_output. - Repeat Continue until a response has no
computer_call.
Action types
Safety
The model acts on whatever the screen shows, and page content is untrusted input. OpenAI’s guidance is to isolate the environment, restrict which sites the agent can reach, and keep a human in the loop for consequential steps. An Orgo computer covers the isolation half: the blast radius is that one computer, andcomputer.destroy() ends it.
Best practices
1. Clear instructions
2. Error handling
3. Session management
4. Timing considerations
Migrating from the preview tool
The preview integration still runs. These are the differences:
The preview tool declares its own display size, so on a default Orgo computer set
display_width: 1280 and display_height: 720 to match the screenshots you send.
Comparison with Claude
Next steps
OpenAI Docs
Official OpenAI computer use documentation
Orgo Quickstart
Learn more about Orgo computers