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

# aether computer

> Turn this computer's switches on or off: agents Aether starts here, and changes from your other devices

Settings of the computer you run the command on, which [`aether setup`](https://docs.runaether.dev/quickstart#step-2-run-aether-setup) registered with Aether. A computer has two switches, and each is off until you turn it on:

| Switch | Command | While it is on |
| - | - | - |
| Let Aether start agents here | `aether computer agents on` | Aether may start agents on this computer, in your connected repositories. |
| Changes from other devices | `aether computer remote-changes on` | From your other devices you can open a terminal on this computer in a task's folder, and write, make, rename, delete and revert the files of that folder. |

Only the computer itself turns a switch on: the command goes through the computer's own connection to Aether, under the sign-in of your coding agent's bridge. Aether e-mails you each time a switch is turned on, whatever your notification settings say. From anywhere else a switch can only be turned off.

`aether setup` asks about each switch that is off, and leaves it off when you answer no. It never turns a switch off. Resetting a computer in Aether turns both off.

## Usage

```bash theme={"dark"}
aether computer agents on [--limit N]
aether computer agents off
aether computer remote-changes on
aether computer remote-changes off
```

Each command prints how the switch stands afterwards. With `--json` it prints the computer as Aether answers it.

## Let Aether start agents here

```bash theme={"dark"}
aether computer agents on --limit 2
```

| Flag | Description |
| - | - |
| `--limit` | The most agents Aether runs on this computer at once, from 1 to 16 (1 by default) |

The agents run with this computer's own Claude Code, its settings and its sign-in, and cost nothing in Aether: Aether passes them no API key or other provider credential.

`aether computer agents off` stops Aether from starting agents here.

## Changes from other devices

```bash theme={"dark"}
aether computer remote-changes on
```

Reading a task's files and its diff needs no switch.

The file tree and the editor never read, write, rename or delete a file git ignores (a `.env`, for one), anything under `.git`, or a file named like a credential, and never change anything outside the task's folder.

The terminal has no such limits. It is your own login shell, started in the task's folder and running as your user on this computer, as a terminal you open yourself does: whatever you or a command typed there can reach on this computer, it can read and change, the files above and anything outside the task's folder included.

`aether computer remote-changes off` turns it off again. Turning it off ends every terminal open on this computer from another device.

## Turn a switch off from anywhere

In the web app or the phone app, open **Settings > Computers** and choose **Turn off** beside the switch. Aether asks first, and for changes from other devices says that every terminal open on that computer from another device ends. To turn a switch on again, run its command on the computer.


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