Installs to ~/.nexus-cli, links nexus into ~/.local/bin, and adds it to your PATH.
nexus mobile), also install qrencode — the installer will remind you.nexus login yourname — it prompts for your password and saves a token.nexus mobile — shows a QR in the terminal; scan it with the Nexus app on your phone and approve. No password typed.| nexus | Show help & your login status |
| nexus login <user> | Sign in with a password |
| nexus mobile | Sign in by scanning a QR with your phone |
| nexus servers | List your servers |
| nexus channels <server> | List channels in a server |
| nexus dms | List your direct-message conversations |
| nexus read <channel> [n] | Print the last n messages (default 20) |
| nexus send <channel> … | Post a message to a channel |
| nexus dm <user> … | Send a direct message |
| nexus gif "query" | Search GIFs (add --to @user --pick N to send) |
| nexus upload <channel> <file> | Upload & post an image |
| nexus watch [channel] | 🔴 Live-tail a channel — or everything |
| nexus logout | Clear your saved token |
| nexus version | Show the installed version |
| nexus update | Update the CLI to the latest release |
| nexus settings [key value] | View / change config |
| nexus service [action] | Install / manage the always-on auto-updater |
On startup the CLI checks for a newer version and asks you: Y update now · n skip · l later (snoozes 24h). Or let a background service handle it:
| nexus settings | Show all settings (~/.config/nexus-cli/config.json) |
| nexus settings interval 2h | How often the service checks (30m, 2h, 1d, …) |
| nexus settings updates off | Turn off the startup update prompt |
| nexus settings auto off | Stop the service auto-applying updates |
| nexus service status / restart / stop / remove | Manage the updater service |
The service uses systemd where available (survives reboot & logout), and falls back to nohup otherwise. Disable startup checks anytime with NEXUS_NO_UPDATE_CHECK=1.
nexus watch streams every message and DM into your terminal in real time (same long-poll engine as the web app), color-coded with channel & server names. Watch one channel with nexus watch lobby-general.$NEXUS_URL — point at a different backend (default https://luisearch.pages.dev).
$NEXUS_TOKEN — act as a specific account for one command without logging in.
Token is stored at ~/.config/nexus-cli/token (chmod 600).