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

# Headless CLI

> The few commands worth remembering.

After install, `vued` is enough. If setup is missing, it starts setup.

## Essentials

| Need                | Command               |
| ------------------- | --------------------- |
| Check setup/runtime | `vued status`         |
| Start runtime       | `vued daemon start`   |
| Stop runtime        | `vued daemon stop`    |
| Restart runtime     | `vued daemon restart` |
| See logs            | `vued daemon logs`    |
| Health check        | `vued doctor`         |
| Update              | `vued update`         |
| Check update        | `vued update --check` |

## Auth

| Need              | Command              |
| ----------------- | -------------------- |
| Sign in / setup   | `vued setup`         |
| Switch account    | `vued setup --reset` |
| Re-sign in        | `vued setup --reset` |
| Clear saved setup | `vued logout`        |

If auth expires and refresh cannot fix it, run `vued setup --reset`.

## MCP

```bash theme={null}
vued mcp install
```

Specific tools:

```bash theme={null}
vued mcp install --mcp-targets claude-code,codex,codex-desktop,claude-desktop,cursor
```

Run the MCP server:

```bash theme={null}
vued mcp
```

## Uninstall

```bash theme={null}
vued uninstall
```

Keep local cache:

```bash theme={null}
vued uninstall --keep-data
```

## Notes

* Headless binds to `127.0.0.1`.
* Headless creates/stores its own scoped API key during setup.
* First-time encryption passphrase creation still happens in Desktop.
* Auto-update runs once per day before normal CLI commands. Disable with `VUED_AUTO_UPDATE=0`.