Desktop app

The desktop app is the primary local home for xopc. It includes the Gateway console, starts the local service when needed, and brings conversation, user understanding, Projects, Tasks, models, permissions, and run history into one place without keeping a terminal open.

Install

1. Open the xopc.ai download page.
2. Choose your platform and download the newest package for your computer.
3. Install and launch xopc.

Platform	Package
macOS	.dmg
Windows	.exe matching your x64 or ARM64 system
Linux	.AppImage or .deb

On macOS, move xopc to Applications. On Windows, run the installer. On Linux, install the .deb or allow the .AppImage to run.

Release notes and direct historical artifacts remain available on GitHub Releases.

First run

1. Wait for the local Gateway to become ready.
2. Follow the model setup screen and connect one provider.
3. Open Chat and keep the default Agent selected.
4. Send: Reply with “xopc is ready” and tell me which model you are using.

Once that reply succeeds, the core setup is complete. Add channels, remote access, browser automation, or more Agents one at a time.

For provider choices and credential methods, see Configure a model.

Start getting acquainted

After the model connection works, give xopc one real direction:

One thing I want to move forward this week is ____.
Help me clarify the outcome and identify the smallest credible next step.

Some releases also show experimental Connect recent work onboarding. This flow analyzes only folders you select, uses a bounded read-only scope, and shows evidence for its next-step suggestions. On macOS it may separately request access to Apple Notes, Calendar, and Reminders. Each permission is optional; you can skip the flow and begin with conversation.

Review proposed long-term understanding under You or User context. Confirm what is accurate and useful; correct, reject, or delete the rest. See User understanding.

Find common features

You want to…	Open
Review or correct what xopc knows	You or User context
Start or resume a conversation	Chat
Create and edit assistants	Agents
Organize ongoing work	Projects or Tasks
Connect Telegram, Weixin, or Feishu	Channels
Create repeated work	Workflows or Automations
Inspect a problem	Settings → Logs
Pair another device	Settings → Remote access
Check for updates	Settings → Gateway

The desktop app and terminal commands use the same xopc data by default, so you can start in the app and later run xopc, xopc agent, or xopc gateway without creating a separate setup.

Data and privacy

xopc stores its configuration, local database, Agents, and workspaces under ~/.xopc/ by default. Model requests still go to the provider you choose unless you use a local model.

Read Data and file locations for backup and path details. Local storage does not prevent selected context from being sent to a configured cloud model. Use a local model when a task must remain on-device. Do not include keys, tokens, private chats, or personal paths in screenshots.

Troubleshooting

Symptom	What to do
The Gateway does not start	Close other xopc windows, relaunch, and check whether the configured port is already in use
Model setup fails	Re-enter the credential, check the selected model, then follow Configure a model
The window opens but content stays blank	Restart the app; on Windows, install current graphics drivers
A channel or phone cannot connect	Confirm local chat works, then review Channels or Remote access

If the problem remains, run xopc doctor in a terminal and follow Troubleshooting.