Back to button-first setup

Advanced setup

This page is for teams that manage Homer through local configuration, shell scripts, or editor internals. Most users should use the button-first setup page.

Claude Code

Claude Code uses the same Homer connector pattern as Cursor and Codex. Advanced installers may still use the plugin marketplace commands from the beta quickstart.

Cursor

Cursor uses a local Homer connector through its external tool configuration. Advanced installers can generate the Add-to-Cursor deeplink with the existing local script.

Codex

Codex uses the Homer plugin package. Advanced installers can add the local marketplace and then install Homer from the Plugins tab.

Remove Homer

The uninstall command removes Homer integrations from selected local coding agents and backs up touched config under ~/.homer-uninstall-backups. By default it removes the shared local API-key settings when removing all agents. Add purge=1 to also remove downloaded Homer client/state.

Windows

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm '/uninstall.ps1?run=1' | iex"

macOS

curl -fsSL '/uninstall.sh?run=1' | sh

To remove only some integrations, add apps=cursor, apps=claude-code, apps=codex, or a comma-separated combination to the URL.

Internal terms

Maintainers may see words such as hook, MCP, environment variable, PowerShell, and JSON in internal files. Those details should stay out of the default customer path.