Terminal quick start

This is the shortest path from a new installation to a working terminal conversation.

1. Install xopc

On macOS, Linux, WSL2, or Termux:

curl -fsSL https://xopc.ai/install.sh | bash

If Node.js 22 or newer is already installed:

npm install -g @xopcai/xopc

On Windows PowerShell:

iex (irm https://xopc.ai/install.ps1)

Confirm that the command is available:

xopc --version

2. Connect one model

Run the short setup wizard:

xopc onboard --quick

Choose one provider, enter its credential, and select a model. Gateway, channels, skills, and additional Agents can wait.

3. Start chatting

xopc

Send a small verification prompt:

Reply with “xopc is ready” and tell me which model you are using.

Exit with the key shown in the TUI help. The Session is saved, so you can resume it later with xopc resume.

4. Start with one important thing

Give xopc one real direction without expecting it to know you already:

One thing I want to move forward this week is ____.
Ask only for missing context, help me define what done means,
and propose the smallest credible next action.

The assistant can use enabled tools and your workspace when the task requires them. It should ask before actions that need missing access or credentials. Review any proposed long-term understanding instead of assuming every message should be remembered.

If it does not work

xopc models status
xopc doctor
xopc logs tail

• If no provider is configured, follow Configure a model.
• If the command is not found, open a new terminal and verify that the installer added xopc to PATH.
• If the model rejects the request, verify the key, model name, account balance, and network access.

Continue with User understanding, Chat and sessions, or open the browser console with xopc gateway.