Lifecycle
Updates and Uninstall
Refresh Origin's local runtime, verify version health, restart MCP clients, and remove the service without losing data by accident.
At a glance
01
Use setup and doctor to refresh and verify the local runtime under ~/.origin/bin.
02
Uninstalling the service is separate from deleting memory data; keep those decisions explicit.
01
When to update
Update when release notes mention a setup fix, new MCP client support, service-management change, or runtime bug that affects your machine.
If everything is working, you do not need to chase every main-branch PR. Use the changelog to distinguish stable releases from unreleased work.
02
Refresh the local runtime
For MCP clients outside Claude Code, rerun the setup command to refresh the local CLI, daemon, and MCP connector installed under ~/.origin/bin.
After updating, run status and doctor before judging the client integration. That separates a runtime problem from a client restart or settings problem.
Terminal
# refresh the local runtime installed under ~/.origin/bin
npx -y @7xuanlu/origin setup
# verify after any update
~/.origin/bin/origin status
~/.origin/bin/origin doctor03
Claude Code plugin users
Claude Code plugin updates happen through Claude Code's plugin marketplace flow. After the plugin changes, restart Claude Code if prompted and run /init again.
/init verifies the plugin, daemon, MCP route, and a memory round trip, so it is the right post-update check.
Claude Code
/init04
MCP client settings
If origin-mcp moved, or a client still launches an old path, rerun origin mcp add for that client. Use --dry-run when you want to inspect the generated config first.
Most MCP clients need a restart after settings change. Verify by running the client's Origin doctor or a small capture/recall round trip.
MCP refresh
~/.origin/bin/origin mcp add codex --dry-run
~/.origin/bin/origin mcp add cursor05
Uninstall the service
origin uninstall removes the per-user service registration: launchd on macOS, systemd user units on Linux, or the Windows Task Scheduler logon task.
That does not delete memory data. Do not delete ~/.origin or the daemon data directory unless you have decided you no longer need those records.
Terminal
~/.origin/bin/origin uninstall
# then remove Origin from each MCP client's settings if you added it manually06
Before deleting data
Memory data may include project history, private preferences, client context, pages, sessions, and local git history. Treat it like private application data.
If you are removing Origin because setup failed, open an issue with redacted doctor output before deleting data. The diagnostic state is often the fastest way to fix the install path.
Next
Upgrade Notes
Read the practical upgrade path for Origin releases: what to rerun, what to verify, and what changed in the current public runtime shape.
Read next