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

# CLI reference

> Every atlaso command — what it does, when you need it, and what it won't touch.

The `atlaso` CLI links a machine to your account and manages which tools on it
share your memory. You get it from the [install command](/install).

Check your version with `atlaso --version`. Everything on this page is v0.5.1.

## atlaso connect

Links this machine to your Atlaso account.

```bash theme={null}
atlaso connect
```

Opens your browser, you click **Authorize**, and the CLI then runs the tool
picker (the same thing [`atlaso setup`](#atlaso-setup) does). The installer runs
this for you, so you usually only type it yourself when reconnecting.

| Flag          | What it does                                                                   |
| ------------- | ------------------------------------------------------------------------------ |
| `--force`     | Reconnect even if this device is already linked.                               |
| `--tool <id>` | Scope the connection to one tool. Advanced — the picker handles this normally. |

If the machine is already connected, `connect` says so and stops rather than
churning your credential. It always re-links the **same** device rather than
creating a new one, which matters on Free (one device) and keeps your removal
history intact.

<Note>
  The authorization never leaves your machine in a usable form: the secret half
  of the exchange stays in the CLI process, so a copied approval link can't be
  redeemed by anyone else.
</Note>

## atlaso setup

Chooses which AI tools on this machine share your memory.

```bash theme={null}
atlaso setup
```

Lists the tools it found, installs the integration for each one you pick, and
tells you if a tool needs a restart to activate. Run it again any time to add or
change tools.

| Flag            | What it does                                                                             |
| --------------- | ---------------------------------------------------------------------------------------- |
| `--tools <ids>` | Skip the picker — comma-separated ids, e.g. `--tools codex,claude-code`. For automation. |

On **Free** you pick one tool. On **Pro** it's a multi-select with no limit. With
no interactive terminal, `setup` requires `--tools` rather than hanging.

## atlaso status

Shows what's actually true on this machine.

```bash theme={null}
atlaso status
```

Reports your device, your plan, and each tool's state — whether the tool is on
this machine, whether our integration is installed into it, and whether memory is
actively syncing. Add `--json` for machine-readable output.

## atlaso sync

Reconciles your dashboard with what's really installed here.

```bash theme={null}
atlaso sync
```

If you remove a plugin by hand, nothing tells us — so the tool keeps showing as
linked in your dashboard. `sync` compares the two and clears the difference.

<Warning>
  If this machine still holds a shared credential, removing a tool revokes that
  credential and signs the machine out until you run `atlaso setup` again. The
  CLI warns you before doing it. Your memories are never affected.
</Warning>

Claude Desktop and [Custom MCP](/tools/custom-mcp) connect as their own devices,
so `sync` can't see them. Remove those from **Connections** in the dashboard.

## atlaso unlink

Stops one tool on this machine from sharing memory.

```bash theme={null}
atlaso unlink          # pick from this device's tools
atlaso unlink codex    # or name it
```

Revokes that tool's access on the server, then removes its integration locally.
Both halves matter: revoking access while leaving the plugin installed doesn't
stop the tool, and removing the plugin without revoking leaves a live credential.

The same shared-credential warning as `sync` applies, and the CLI tells you
before it happens.

## atlaso disconnect

Disconnects the whole machine.

```bash theme={null}
atlaso disconnect
```

Atlaso stops syncing memory to this device and every tool on it. **Your memories
stay safe** — this unlinks a machine, it doesn't delete anything.

| Flag      | What it does                                                     |
| --------- | ---------------------------------------------------------------- |
| `--force` | Retire the local credential even if the server can't be reached. |

Installed plugins stay on disk; `disconnect` prints the command to remove each
one. Reconnect any time with `atlaso connect` — you'll land on the same device.

## Environment variables

| Variable              | What it does                                                                  |
| --------------------- | ----------------------------------------------------------------------------- |
| `ATLASO_NO_CONNECT=1` | Installer only: install the binary, skip the browser handoff.                 |
| `ATLASO_INSTALL_URL`  | Installer only: download binaries from a different base URL.                  |
| `ATLASO_HOME`         | Use a different home than `~/.atlaso` (macOS/Linux).                          |
| `ATLASO_NO_BROWSER=1` | Never open a browser — print the authorization link instead. Useful over SSH. |
| `ATLASO_SERVER`       | Point the CLI at a different Atlaso server.                                   |

## Exit codes

| Code | Meaning                                                                                    |
| ---- | ------------------------------------------------------------------------------------------ |
| `0`  | Success.                                                                                   |
| `1`  | Something failed — the CLI says what, and nothing was half-changed.                        |
| `2`  | You need to do something first: not connected, or no terminal for a prompt that needs one. |