system

Get the current or last known install job status for a system target

get/api/v1/system/install/{target}

Path parameters

target'tmux' | 'gh' | 'claude' | 'codex' | 'opencode' | 'copilot' | 'cloudflared' required

Install target identifier: tmux, gh, claude, codex, opencode, copilot, or cloudflared.

Install target identifier: tmux, gh, claude, codex, opencode, copilot, or cloudflared.

Response

OK

commandstring

Human-readable install command, e.g. "brew install tmux", for display even before/without output.

errorstring

Set on failure or when the target is unsupported on this machine: the exec error, the Unsupported reason, or a timeout message.

expectedDestinationstring

Expected or adapter-resolved executable destination.

finishedAtstring date-time nullable

Absent until the job finishes.

methodstring

Server-owned installation method selected for this harness job.

outputstring

Combined stdout+stderr from the install command, tail-capped to the last ~4000 bytes.

startedAtstring date-time nullable
status'idle' | 'running' | 'installing' | 'verifying' | 'succeeded' | 'failed' | 'unsupported' | 'interrupted' required

Current lifecycle state of the job.

target'tmux' | 'gh' | 'claude' | 'claude-code' | 'codex' | 'cursor' | 'opencode' | 'aider' | 'copilot' | 'grok' | 'kimi' | 'pi' | 'amp' | 'auggie' | 'droid' | 'crush' | 'cline' | 'goose' | 'qwen' | 'continue' | 'devin' | 'kiro' | 'kilocode' | 'vibe' | 'muse' | 'agy' | 'autohand' | 'kimchi' | 'prime-agent' | 'omp' | 'unreal-agent' | 'cloudflared' required

Fixed install target this job ran (or is running) for.

updatedAtstring date-time nullable

Changes

Changed in 5 of the 169 revisions of this API.12914

    • ●

      added the new unreal-agent enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • dbac6f89334812710See the full diff
    • ▲

      the path request parameter target was restricted to a list of enum values

      request-parameter-became-enum

    • ●

      added the new agy enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new aider enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new amp enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new auggie enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new autohand enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new claude-code enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new cline enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new continue enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new crush enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new cursor enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new devin enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new droid enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new goose enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new grok enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new installing enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new interrupted enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new kilocode enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new kimchi enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new kimi enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new kiro enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new muse enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new omp enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new pi enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new prime-agent enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new qwen enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new verifying enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new vibe enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value claude to the path request parameter target

      request-parameter-enum-value-added

    • ○

      added the new enum value cloudflared to the path request parameter target

      request-parameter-enum-value-added

    • ○

      added the new enum value codex to the path request parameter target

      request-parameter-enum-value-added

    • ○

      added the new enum value copilot to the path request parameter target

      request-parameter-enum-value-added

    • ○

      added the new enum value gh to the path request parameter target

      request-parameter-enum-value-added

    • ○

      added the new enum value opencode to the path request parameter target

      request-parameter-enum-value-added

    • ○

      added the new enum value tmux to the path request parameter target

      request-parameter-enum-value-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ●

      added the new cloudflared enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      endpoint added

      endpoint-added