Record that a folder's next terminal chat is a fork of a chat
curl --request POST \
--url https://api.runaether.dev/computers/{computerID}/pending-terminal-forks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"folder": "<string>",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.runaether.dev/computers/{computerID}/pending-terminal-forks"
payload = {
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"folder": "<string>",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
chat_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
folder: '<string>',
task_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://api.runaether.dev/computers/{computerID}/pending-terminal-forks', 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}/pending-terminal-forks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'chat_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'folder' => '<string>',
'task_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/computers/{computerID}/pending-terminal-forks"
payload := strings.NewReader("{\n \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"folder\": \"<string>\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.runaether.dev/computers/{computerID}/pending-terminal-forks")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"folder\": \"<string>\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/pending-terminal-forks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"folder\": \"<string>\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"expires_at": "2023-11-07T05:31:56Z",
"folder": "<string>",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"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>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Computers
Record that a folder's next terminal chat is a fork of a chat
Records the caller's word that the next terminal chat created in a folder of their computer is a fork of one of their Aether chats: when the machine bridge first mirrors a Claude Code session of that folder's work tree, its chat names the Aether chat as the chat it was forked from. Answers 201 with the pending fork and when it expires.
Use this tool when you need to:
- Link the chat Claude Code forks on your computer to the Aether chat it continues, as `aether task chats continue` does before it prints the resume command
Examples:
- POST /computers/{computerID}/pending-terminal-forks {"task_id": "5b0c1f8e-2a4d-4c3b-9e7f-1d2a3b4c5d6e", "chat_id": "8d7e6f5a-4b3c-4d2e-9f1a-0b9c8d7e6f5a", "folder": "/Users/ada/src/aether-fix-login"}
Hints:
- folder is the work tree's folder as the machine bridge reports it: the top of the git checkout, its path resolved (/private/tmp, not /tmp, on macOS).
- The fork is taken once: by the first terminal chat created in a work tree of that folder, and only one of the caller's. It expires 24 hours after it is recorded, and a terminal chat created after that is no fork. Recording again for the same folder replaces it.
- The lineage comes from this record alone, never from the session file, which names no source once Claude Code forks it.
- Only the task's creator records a fork of its chats, while they can read the task in its organization: a task they cannot read or did not create answers 404 not_found, as does a computer that is not theirs or a chat that is no Aether chat of the task.
- Only the grant of the caller's coding agent's bridge on the computer calls it, as `aether task chats continue` does: 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.
POST
/
computers
/
{computerID}
/
pending-terminal-forks
Record that a folder's next terminal chat is a fork of a chat
curl --request POST \
--url https://api.runaether.dev/computers/{computerID}/pending-terminal-forks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"folder": "<string>",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.runaether.dev/computers/{computerID}/pending-terminal-forks"
payload = {
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"folder": "<string>",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
chat_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
folder: '<string>',
task_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://api.runaether.dev/computers/{computerID}/pending-terminal-forks', 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}/pending-terminal-forks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'chat_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'folder' => '<string>',
'task_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.runaether.dev/computers/{computerID}/pending-terminal-forks"
payload := strings.NewReader("{\n \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"folder\": \"<string>\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.runaether.dev/computers/{computerID}/pending-terminal-forks")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"folder\": \"<string>\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/pending-terminal-forks")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"chat_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"folder\": \"<string>\",\n \"task_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"chat_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"expires_at": "2023-11-07T05:31:56Z",
"folder": "<string>",
"task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}{
"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>"
}
]
}{
"code": "account_deleting",
"error": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
]
}Authorizations
Path Parameters
Body
application/json