Claude Code
Discover, install, and start a local XO Space with the Quirq plugin for Claude Code.
The Quirq plugin adds local Space discovery and explicit install/start commands to Claude Code. Installing the plugin and installing the Space server are separate steps.
Install the plugin
Run these commands in Claude Code:
/plugin marketplace add quirq-ai/xo-space
/plugin install quirq@quirq-aiquirq-ai is the marketplace name; quirq is the plugin identifier in the
source manifest.
Start a new Claude Code session if the installed commands are not yet available.
Check the server
/quirq:statusThis is a read-only discovery command. It checks the server's install pointer, probes its health endpoint, and can inspect the current directory for a checkout. It reports one of three states:
| State | Meaning | Next step |
|---|---|---|
running | A local Space responds. | Open the reported /space/ URL. |
installed | A checkout was found, but no server is running. | Use /quirq:start when ready. |
not_installed | No usable local installation was found. | Choose a workspace and use /quirq:install. |
Discovery reads ~/.config/quirq/install.json, written on server boot. It probes
the recorded port first, then local defaults 5002/5003. Checking status does not
install, update, or start a server.
Install a Space
Choose the directory whose child folders should become projects. Supply that path explicitly:
/quirq:install /absolute/path/to/workspaceThe command checks for an existing installation, presents the destination and installation steps, and asks you to confirm. It then runs the official installer, waits for health, and reports the UI URL, log path, and configuration file. It does not reinstall over an existing server.
When launched by the plugin, the server runs as a background task of that Claude Code session. It is not installed as an operating-system service and may stop when the session or task ends. To run it independently, use a terminal and follow Install Space.
Start an existing installation
/quirq:startThis starts the existing checkout without fetching an update. It reports the server URL if Space is already running. Updating is a separate operation: use the documented update path.
You can also ask in plain language, such as “Is my local Space running?” or “Start my installed Space.” The bundled skill uses the same discovery and lifecycle rules. Credentials and connector OAuth flows belong in Space's Setup and Connectors tabs.
Work in a project
After the server is running, open the reported URL. The current UI opens on
Dashboard under Projects; click Projects for List. The plugin also bundles the
xo-projects skill for project creation, operating documents, shared todos,
Inbox items, and the backup/restore API.
Ask Claude Code to create an xo-project with a clear name and purpose, then follow Your First Space. The skill discovers the configured root and uses Space's project API; an agent's private todo list alone does not update the project's shared todos.
The plugin README lists the commands shipped by the current source revision.