orgo_list_computers
Read-onlyIdempotent
List computers in a project to retrieve IDs, names, and status for use with action tools like screenshot, click, or bash commands.
Instructions
List all computers in a project.
Returns computer IDs, names, and status with pagination. Use computer_id
with action tools like orgo_screenshot, orgo_click, orgo_bash, etc.
Args:
params (ListComputersInput): Input parameters containing:
- project_name (str): Project name from orgo_list_projects
- limit (int): Maximum results, 1-100 (default: 20)
- offset (int): Skip for pagination (default: 0)
- response_format (ResponseFormat): 'markdown' or 'json'
Returns:
str: Formatted response containing:
Markdown format:
# Computers in project-name
Found X computers (showing Y)
## dev-box (`comp_abc`)
- **Status**: running
- **OS**: linux
- **RAM**: 4 GB | **CPU**: 2 cores
JSON format:
{
"total": int,
"count": int,
"offset": int,
"has_more": bool,
"next_offset": int | null,
"computers": [{"id": str, "name": str, "status": str, "os": str, "ram": int, "cpu": int}]
}
Examples:
- "List computers in my-project" -> params with project_name="my-project"
- "Show running VMs" -> list then filter by status
Error Handling:
- Returns "Project 'name' not found" if project doesn't exist
- Returns "No computers found in project" if emptyInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |