List the tasks a computer is to start
curl --request GET \
--url https://api.runaether.dev/computers/{computerID}/task-starts \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/computers/{computerID}/task-starts"
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/{computerID}/task-starts', 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/{computerID}/task-starts",
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/{computerID}/task-starts"
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/{computerID}/task-starts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/task-starts")
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": [
{
"base_branch": "<string>",
"branch": "<string>",
"checkout": "<string>",
"folder": "<string>",
"fork": {
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"subagents": [
"<string>"
]
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"prompt": "<string>",
"repository": {
"name": "<string>",
"owner": "<string>"
},
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "pending",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent": "<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>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"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 the tasks a computer is to start
Lists the starts the caller’s machine bridge has not carried out, the oldest first: each a task started on the computer whose work tree the bridge has not made (pending), or whose first message’s run it has not asked for (prepared).
Use this tool when you need to:
- Make the work trees of the tasks started on the computer while the bridge was not connected, whose start_task command expired
- Learn, after the bridge restarted, which starts it left unfinished
- Find the work tree a run’s session starts in, when Claude Code holds no file of the session yet: the session of a task started on the computer exists only once its first run starts it
Examples:
- GET /computers//task-starts
- GET /computers//task-starts?session_id=8a1f2c3d-4b5e-4f60-8a7b-9c0d1e2f3a4b
Hints:
- Without session_id, lists none while the computer does not let Aether start agents: a start waits until the computer turns that on.
- With session_id, lists the start whose task’s main chat is that session, in whatever state, or none: start the session in a prepared start’s folder, under the session’s id.
- A start Aether ended (its task was archived, it waited 24 hours from when it was written, or the sign-in or API key it was made with ended) is never listed, and getComputerTaskStart answers it 404 not_found.
- Make each pending start’s work tree and report it with reportComputerTaskStart; ask to run each prepared start’s first message (first_message_id) with reportTerminalChatRun.
- A computer that is not the caller’s is refused with 404 not_found.
- Only the grant of the caller’s coding agent’s bridge calls it, the machine bridge on the computer: a session or an API key is refused with 403 credential_kind_not_admitted.
- The call presents the computer’s own secret, which aether setup keeps on it, in the Aether-Computer-Secret header. A computer that has none is refused with 403 computer_needs_setup: update the aether CLI there and run aether setup. A call that presents no secret, or another, is refused with 403 computer_set_up_elsewhere.
GET
/
computers
/
{computerID}
/
task-starts
List the tasks a computer is to start
curl --request GET \
--url https://api.runaether.dev/computers/{computerID}/task-starts \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/computers/{computerID}/task-starts"
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/{computerID}/task-starts', 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/{computerID}/task-starts",
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/{computerID}/task-starts"
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/{computerID}/task-starts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/task-starts")
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": [
{
"base_branch": "<string>",
"branch": "<string>",
"checkout": "<string>",
"folder": "<string>",
"fork": {
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"subagents": [
"<string>"
]
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"prompt": "<string>",
"repository": {
"name": "<string>",
"owner": "<string>"
},
"session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"state": "pending",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent": "<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>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}