> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml api-reference/openapi.json GET /computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file
openapi: 3.1.0
info:
  title: Aether API
  version: 0.1.0
servers:
  - url: https://api.runaether.dev
security:
  - bearerAuth: []
paths:
  /computers/{computerID}/tasks/{taskID}/chats/{chatID}/session-file:
    get:
      tags:
        - computers
      summary: Export a chat's Claude Code session file to a computer
      description: >-
        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.
      operationId: exportChatSessionFile
      parameters:
        - in: path
          name: computerID
          required: true
          schema:
            format: uuid
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
            type: string
        - in: path
          name: taskID
          required: true
          schema:
            format: uuid
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
            type: string
        - in: path
          name: chatID
          required: true
          schema:
            format: uuid
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
            type: string
      responses:
        '200':
          content:
            application/x-ndjson:
              schema:
                contentMediaType: application/octet-stream
                format: binary
                type: string
          description: The chat's Claude Code session file
          headers:
            X-Claude-Session-Id:
              description: >-
                The Claude Code session id the file is of: its name is
                <id>.jsonl
              schema:
                format: uuid
                type: string
            X-Task-Branch:
              description: The branch the chat's task works on
              schema:
                type: string
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ComputersErrorResponse'
                  - $ref: '#/components/schemas/OrgAuthorizationErrorResponse'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Not Found
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Conflict
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Gone
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Unprocessable Entity
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Internal Server Error
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ComputersErrorResponse'
          description: Service Unavailable
components:
  schemas:
    ComputersErrorResponse:
      additionalProperties: false
      properties:
        code:
          enum:
            - account_deleting
            - aether_inference_unserved
            - agent_pr_blocked
            - agent_pr_pending
            - agent_profile_changed
            - agent_starts_off
            - agent_starts_on_from_computer_only
            - agent_uses_own_sign_in
            - answer_on_its_way
            - app_identity_missing
            - attachments_unsupported
            - attribution_unavailable
            - bad_gateway
            - bad_request
            - base_branch_unusable
            - branch_exists
            - caller_inactive
            - chat_archived
            - chat_being_forked
            - chat_moved
            - chat_not_removable
            - chat_settings_fixed
            - chats_not_addable
            - checkout_not_archivable
            - cli_upgrade_required
            - client_outdated
            - computer_cli_outdated
            - computer_needs_fresh_sign_in
            - computer_needs_setup
            - computer_registered_to_another_person
            - computer_set_up_elsewhere
            - computer_starts_no_agents
            - computer_starts_no_forks
            - computer_task_start_moved
            - computer_unreachable
            - conflict
            - connection_creator_only
            - connection_harness_mismatch
            - connection_not_held
            - contents_write_required
            - continuation_failed
            - continuation_unavailable
            - control_forbidden
            - credential_kind_not_admitted
            - credential_named_file
            - detached_head
            - download_unsupported
            - embeddings_unavailable
            - feature_unsupported
            - file_references_unsupported
            - fix_not_requested
            - fix_requests_unrecorded
            - forbidden
            - fork_branch_delete_unsupported
            - fork_forbidden
            - fork_in_progress
            - fork_unsupported
            - gateway_timeout
            - github_failed
            - github_identity_required
            - github_push_access_required
            - gone
            - handed_branch_protected
            - head_moved
            - html_render_nul_byte
            - html_render_too_large
            - idempotency_key_conflict
            - idempotency_key_reused
            - idle_compaction_not_pending
            - idle_compaction_skipped
            - inference_proxy_unavailable
            - insufficient_credits
            - insufficient_inference_balance
            - interaction_mode_unsupported
            - internal_error
            - invalid_request
            - last_queued_message
            - live_protocol_unsupported
            - main_chat_permanent
            - mcp_server_not_connected
            - merge_when_ready_requires_pr_review
            - message_not_queued
            - message_not_waiting
            - method_not_allowed
            - mode_forbidden
            - name_follows_session
            - no_checkout_on_computer
            - no_checkpoint_yet
            - no_commit
            - no_dispatch_target
            - no_main_chat
            - no_origin
            - no_work_tree_folder
            - not_acceptable
            - not_found
            - not_implemented
            - onboarding_already_completed
            - onboarding_requirements_missing
            - open_in_terminal
            - org_id_required
            - org_role_insufficient
            - org_suspended
            - payment_required
            - pending_input_answered
            - permission_prompt_open
            - pr_automation_unsupported
            - pr_review_actor_required
            - pr_review_connection_spent
            - pr_review_publish_forbidden
            - precondition_failed
            - project_has_no_repository
            - project_not_a_choice
            - project_required
            - prompt_decisions_refused
            - pull_request_closed
            - pull_request_mirror_failed
            - pull_request_not_mirrored
            - push_failed
            - question_answers
            - question_shortened
            - queue_for_later_unsupported
            - queued_stop_requires_discard
            - rate_limited
            - reasoning_effort_fixed
            - remote_changes_on_from_computer_only
            - repository_not_connected
            - request_canceled
            - request_expired
            - request_timeout
            - request_too_large
            - review_name_follows_pull_request
            - sandbox_deleted
            - sandbox_failed
            - sandbox_needs_message
            - service_unavailable
            - session_file_generation
            - session_file_hole
            - session_file_missing
            - session_file_range_differs
            - session_gone
            - session_not_started_by_aether
            - slash_commands_unsupported
            - stack_cycle
            - stack_too_large
            - stack_two_parents
            - stale_execution
            - stale_or_indeterminate
            - stale_pending_input
            - start_cancelled
            - stream_delivery_gap
            - stream_event_conflict
            - task_archived
            - task_awaiting_message
            - task_awaiting_tool_response
            - task_backed_by_work_tree
            - task_connection_disconnected
            - task_creator_deleted
            - task_has_no_branch
            - task_has_no_repository
            - task_ineligible
            - task_not_accepting_messages
            - task_not_pinnable
            - task_not_started
            - task_settings_changed
            - task_start_failed
            - task_start_pending
            - teleport_unavailable
            - terminal_chat
            - terminal_chat_continuation_refused
            - terminal_chat_prompt_closed_otherwise
            - terminal_chat_prompt_differs
            - terminal_chat_prompt_not_answered
            - terminal_chat_removed
            - terminal_chat_run_moved
            - terminal_question
            - too_large
            - too_many_live_connections
            - too_many_waiting_messages
            - turn_running
            - unauthenticated
            - unsigned_aether_head
            - unsigned_commit
            - unsupported_changes
            - unsupported_media_type
            - untyped_error
            - user_suspended
            - validation_failed
            - work_tree_repository_differs
            - workspace_git_unavailable
            - workspace_gone
            - workspace_outdated
            - workspace_rejected
            - workspace_start_failed
          minLength: 1
          type: string
        error:
          minLength: 1
          type: string
        errors:
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
      required:
        - error
        - code
      type: object
    OrgAuthorizationErrorResponse:
      additionalProperties: false
      properties:
        code:
          enum:
            - org_membership_required
            - org_role_insufficient
            - org_suspended
            - account_deleting
            - agent_host_route_not_allowed
            - credential_kind_not_admitted
            - grant_scope_insufficient
          type: string
        error:
          minLength: 1
          type: string
      required:
        - error
        - code
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.