List your computers
curl --request GET \
--url https://api.runaether.dev/computers \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/computers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.runaether.dev/computers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.runaether.dev/computers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/computers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.runaether.dev/computers")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"items": [
{
"agent_starts": {
"state": "off"
},
"agents": [
{
"agent_type": "<string>",
"label": "<string>",
"problem": {
"code": "<string>",
"message": "<string>"
},
"version": "<string>"
}
],
"bridge": {
"problem": {
"code": "computer_needs_setup",
"message": "<string>"
},
"version": "<string>"
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_seen_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"reachable": true,
"registered_at": "2023-11-07T05:31:56Z",
"remote_changes": {
"state": "off"
},
"set_up_at": "2023-11-07T05:31:56Z"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "org_membership_required",
"error": "<string>"
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Computers
List your computers
Lists the computers the caller registered with aether setup, oldest first: where their work-tree tasks live.
Use this tool when you need to:
- Name the computer a work-tree task lives on, from the computer_id its machine carries
- Tell whether a computer is reachable, and when it was last seen
- Check from a computer whether aether setup registered it
Examples:
- GET /computers
Hints:
- There are no parameters; the list is the caller’s alone and is returned whole as .
- reachable is whether the computer’s machine bridge is connected to Aether: it is while the bridge’s connection lives, and stops at once when the bridge disconnects, or 20 seconds after the hold of its last poll ends (at most 45 seconds after that poll began) when the bridge stops polling without disconnecting. last_seen_at is when the computer last registered, connected or polled.
- Use registerComputer to register a computer, updateComputer to rename one or turn off its agent starts, removeComputer to remove one, and findWorkTreeTask to find the task of a checkout on one.
- The caller may list with a session, an API key, or the grant of their coding agent’s bridge.
GET
/
computers
List your computers
curl --request GET \
--url https://api.runaether.dev/computers \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/computers"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.runaether.dev/computers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.runaether.dev/computers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/computers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.runaether.dev/computers")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"items": [
{
"agent_starts": {
"state": "off"
},
"agents": [
{
"agent_type": "<string>",
"label": "<string>",
"problem": {
"code": "<string>",
"message": "<string>"
},
"version": "<string>"
}
],
"bridge": {
"problem": {
"code": "computer_needs_setup",
"message": "<string>"
},
"version": "<string>"
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_seen_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"reachable": true,
"registered_at": "2023-11-07T05:31:56Z",
"remote_changes": {
"state": "off"
},
"set_up_at": "2023-11-07T05:31:56Z"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "org_membership_required",
"error": "<string>"
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}