Skip to content

Lifecycle

Updates and Uninstall

Refresh Origin's local runtime, verify version health, restart MCP clients, and remove the service without losing data by accident.

Qi-Xuan LuUpdated 4 min read

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.

Read the changelog

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 doctor

03

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

/init

04

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 cursor

05

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 manually

06

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