Skip to guide

Use onemind with Claude Code

Claude Code (target id claude_code, alias claude) works with the onemind macOS app and CLI. onemind writes one server-composed package to CLAUDE.md in the explicitly bound Project directory. Native BETA sync also maintains a stable user-wide bootstrap in ~/.claude/CLAUDE.md; Project content stays in the bound folder.

macOS app

  1. Sign in to OneMind BETA.app and connect Claude Code from Team where the host supports verified Connect.
  2. Open Mind, choose the intended Project, and bind its exact folder on this Mac.
  3. Open the approved Mind, choose Sync, check the tool/device, and choose Sync now. Wait for confirmed delivery.
  4. Start a fresh Claude Code task from that folder. See Mind Sync for pending, offline, and recovery states.

The native app manages its own connection and folder binding; CLI repository detection is a separate terminal workflow.

CLI

From the repository you use with Claude Code, run:

onemind project claude_code .

The CLI detects Claude Code and prints a message asking you to open onemind and choose the Project Mind for the detected folder. Open the onemind app, find the detected folder in Sync Setup, and bind it to the intended Project Mind. Then run:

onemind sync
onemind status

Confirm that <repository>/CLAUDE.md contains the composed onemind-managed block. On the first write, onemind saves the previous file at <repository>/.one-mind/CLAUDE.md.backup. Start a new Claude Code session.

Claude Code skills are installed to ~/.claude/skills. Use onemind integrations install claude_code to install or update the integration.

If the repository or any parent directory already contains an AGENTS.md file and no CLAUDE.md exists, the CLI will refuse to create CLAUDE.md to avoid changing which shared instructions Claude Code loads. Configure the project's CLAUDE.md and its intended imports manually before running sync.

While a Claude Code task is running, tool permission requests appear in Matrix. As the device owner, you can answer them in Matrix or the macOS app without stopping the task. In the Matrix composer, / slash commands reach Claude Code operations and @ lists Claude Code subagents for the active session.