Skip to content
DevelopersTerminal

Computer CLI reference


Inspect placement targets, change their labels and policy, or open one in Atoi.

On this page

Use this page to inspect every public atoi computer command, its accepted flags, and one runnable example. Return to the CLI reference index to choose another command group.

atoi computerInspect placement targets, change their labels and policy, or open one in Atoi.

CommandWhat it does
atoi computer listList Cloud and connected Computers with availability and policy.
atoi computer getRead one Computer by id or friendly name.
atoi computer renameChange the friendly name shown for a Computer.
atoi computer set-policyChoose when Atoi may place work on a Computer.
atoi computer openOpen the selected Computer in Atoi.

#computer list

List Cloud and connected Computers with availability and policy.

atoi computer list

FlagTypeDefaultValuesWhat it does
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run computer list

bash
atoi computer list --json

#computer get

Read one Computer by id or friendly name.

atoi computer get <computer-id-or-name> [--computer <computer-id>]

FlagTypeDefaultValuesWhat it does
--computerstringSelect a Computer by exact id instead of a positional target.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run computer get

bash
atoi computer get cmp_5r8x --json

#computer rename

Change the friendly name shown for a Computer.

atoi computer rename <computer-id-or-name> --name <name>

FlagTypeDefaultValuesWhat it does
--computerstringSelect a Computer by exact id instead of a positional target.
--name requiredstringSet the new friendly name.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run computer rename

bash
atoi computer rename cmp_5r8x --name "Studio Mac" --json

#computer set-policy

Choose when Atoi may place work on a Computer.

atoi computer set-policy <computer-id-or-name> --policy <ask|always|never>

FlagTypeDefaultValuesWhat it does
--computerstringSelect a Computer by exact id instead of a positional target.
--policy requiredstringask, always, neverSet the placement policy.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run computer set-policy

bash
atoi computer set-policy cmp_5r8x --policy ask --json

#computer open

Open the selected Computer in Atoi.

atoi computer open <computer-id-or-name>

FlagTypeDefaultValuesWhat it does
--computerstringSelect a Computer by exact id instead of a positional target.
--jsonbooleanfalseEmit the canonical JSON envelope.
--ndjsonbooleanfalseEmit one canonical JSON envelope per line.
--formatstringtexttext, jsonChoose human text or the JSON envelope.
--help -hbooleanShow command help.

#Run computer open

bash
atoi computer open cmp_5r8x --json

Was this useful?