Headless CLI - Vued API

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`
Stop runtime + clear saved setup	`vued logout`

If auth expires and refresh cannot fix it, run vued setup --reset. On CLI-only servers, vued setup automatically prints a browser URL/code. Open it on your laptop, sign in, then return to the terminal.

MCP

vued mcp install

Specific tools:

vued mcp install --mcp-targets claude-code,codex,codex-desktop,claude-desktop,cursor

Run the MCP server:

vued mcp

Uninstall

vued uninstall

Keep local cache:

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.

Last modified on June 30, 2026