Export a chat's Claude Code session file to a computer
curl --request GET \
--url https://api.runaether.dev/computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file"
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}/tasks/{taskID}/chats/{chatID}/session-file', 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}/tasks/{taskID}/chats/{chatID}/session-file",
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}/tasks/{taskID}/chats/{chatID}/session-file"
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}/tasks/{taskID}/chats/{chatID}/session-file")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file")
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"<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>"
}
]
}{
"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
Export a chat's Claude Code session file to a computer
Streams the Claude Code session file of one of the caller's Aether chats, as of its latest checkpoint, to one of their computers, so the chat continues there in Claude Code as a fork. The chat is only read: it stays as it is in Aether.
Use this tool when you need to:
- Continue a cloud chat in Claude Code on your computer, as `aether task chats continue` does
Examples:
- GET /computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file
Hints:
- The answer is application/x-ndjson, the session file byte for byte as the chat's session wrote it, with its Claude Code session id in X-Claude-Session-Id and the branch its task works on in X-Task-Branch. Place it as <session id>.jsonl in Claude Code's projects folder of the work tree it continues in, and run claude --resume <session id> --fork-session there.
- The checkpoint holds the session file alone: sub-agents' transcripts are not part of it.
- A stored checkpoint that is not whole (its size or SHA-256 differ from what the checkpoint recorded) breaks the stream off, so a truncated answer never ends cleanly.
- Only the task's creator exports its chats, while they can read the task in its organization: a task they cannot read or did not create answers 404 not_found, whoever else can see it, as does a computer that is not theirs or a chat that is no Aether chat of the task: the export holds sandbox chats alone, so a chat of a task on a computer answers 404 too.
- Refused with 409 and the reason's own code and sentence: turn_running while a turn of the chat is queued, running or stopped and waiting to run again, task_awaiting_tool_response while its agent waits on a question, no_checkpoint_yet before its first turn has left a checkpoint, fork_unsupported for a chat on another harness than Claude Code, and task_has_no_branch for a task with no branch yet.
- 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.
GET
/
computers
/
{computerID}
/
tasks
/
{taskID}
/
chats
/
{chatID}
/
session-file
Export a chat's Claude Code session file to a computer
curl --request GET \
--url https://api.runaether.dev/computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.runaether.dev/computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file"
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}/tasks/{taskID}/chats/{chatID}/session-file', 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}/tasks/{taskID}/chats/{chatID}/session-file",
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}/tasks/{taskID}/chats/{chatID}/session-file"
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}/tasks/{taskID}/chats/{chatID}/session-file")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runaether.dev/computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file")
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"<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>"
}
]
}{
"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
Response
The chat's Claude Code session file
The response is of type file.