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

> Connect OpenCode provider auth by uploading your local auth.json

Manage authentication for the OpenCode agent provider. Connecting uploads the `auth.json` that your local `opencode auth login` wrote, so the OpenCode agent can run in Aether workspaces. See [connect agent providers](/guides/connect-agent-providers).

<Note>
  Log in with `opencode auth login` first. The command reads `${XDG_DATA_HOME:-~/.local/share}/opencode/auth.json` and uploads its contents verbatim.
</Note>

## Usage

```bash theme={null}
aether opencode <subcommand> [flags]
```

## Subcommands

| Subcommand   | Description                            |
| ------------ | -------------------------------------- |
| `connect`    | Upload your local OpenCode `auth.json` |
| `status`     | Show OpenCode auth status              |
| `disconnect` | Remove OpenCode auth                   |

## aether opencode connect

Reads your local OpenCode `auth.json` and uploads its bytes.

```bash theme={null}
aether opencode connect
```

```
OpenCode connected (uploaded 512 bytes from /home/you/.local/share/opencode/auth.json).
```

## aether opencode status

Show whether OpenCode auth is configured.

```bash theme={null}
aether opencode status
```

```
OpenCode: configured (authFile)
```

When nothing is configured, the command prints `OpenCode: not configured` and points you to `connect`.

## aether opencode disconnect

Remove the stored OpenCode auth.

```bash theme={null}
aether opencode disconnect [flags]
```

| Flag      | Description                  |
| --------- | ---------------------------- |
| `--force` | Skip the confirmation prompt |

## See also

* [Connect agent providers](/guides/connect-agent-providers)
* [Agents and models](/concepts/agents-and-models)