installer — clone, build, and add ~/.local/bin/xopc wrapper

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

Configuration

Default: ~/.xopc/xopc.json. A minimal skeleton:

{
  "providers": { "deepseek": "${DEEPSEEK_API_KEY}" },
  "agents": { "default": "main", "list": [{ "id": "main", "models": { "roles": { "deep": { "model": "deepseek/deepseek-v4-flash" } } } }] }
}

Full reference: Configuration. Add channels.* for IM, or browser tools (Playwright Chromium) when needed.

---

Extensions & skills

xopc skills install <name>       # SKILL.md domains
xopc extensions install store:<id>  # or npm:<package> / ./local-directory
xopc extensions dev ./my-extension

Guides: Extensions · Skills. Gateway UI extensions: @xopcai/xopc/extension-ui-sdk (packages/extension-ui-sdk/).

---

FAQ

Is xopc a hosted service? — The xopc application runs on your machine, with configuration and state stored under ~/.xopc/ by default. It can remain standalone or connect explicitly to XOPC Cloud or a private enterprise platform; connecting does not move the local database automatically.

Does local-first mean data never leaves my computer? — Not necessarily. If you select a cloud model, conversation content and context relevant to the request are sent to that model provider. Use a local model and review source and tool permissions for work that must remain on-device.

Does xopc remember everything about me automatically? — No. User understanding can be reviewed, confirmed, corrected, and deleted, and an unconfirmed inference should not become an authoritative fact. Passwords, keys, and other highly sensitive information do not belong in the memory system.

Do I need a paid cloud model? — No. Bring your own keys, or use local models (Ollama, LM Studio, vLLM).

What is the fastest way to try it? — Desktop app for GUI users, or xopc onboard --quick && xopc for terminal.

How is this different from another chat UI? — Chat is only one surface. xopc preserves understanding, long-term goals, projects, tasks, decisions, and run history so the same assistant can continue working across time and surfaces.

Can I use it from my phone or messengers? — Yes. Pair the mobile app by QR code, or configure Telegram, WeChat, or Feishu/Lark via the gateway.

Have a question? — Ask on GitHub Discussions.

---