Setup and recovery

The extension chooses. The Host writes.

Chrome extensions cannot safely write ordinary files by themselves. Clipplane uses a small local Native Host to save Markdown and keep credentials in the operating system store.

Current availability

No public signed installer yet.Clipplane 0.6.0 remains a private candidate. Windows Authenticode and macOS signed and notarized installers have not been published. Do not download Host bundles from third-party mirrors.

Repository setup scripts are intended for maintainers and private source testers. They require the source checkout and a supported Node 20 runtime. Public users should wait for fixed assets on the official GitHub Releases page.

Install on a supported system

Windows

  1. Obtain the signed Windows installer from the official release after it is published.
  2. Run it for the current Windows user. It registers the Host for Chrome and Edge without requesting broad browser access.
  3. Close every browser window, reopen Chrome, then choose Check again in Clipplane.

macOS

  1. Obtain the signed and notarized macOS package from the official release after it is published.
  2. Open the package and complete installation for the current user or the system scope shown by the installer.
  3. Close every browser window, reopen Chrome, then choose Check again in Clipplane.

Full local capture is currently supported on Windows and macOS. Linux is not part of the public 0.6.0 candidate.

Detection and updates

The onboarding page checks the Host version and protocol. A successful check means the browser can reach the expected local Host. It does not enable external sync.

For an update, install the newer signed package over the existing Host, restart every browser window, and check again. Clipplane keeps missing and outdated states separate so reinstalling is not presented as a successful update until the version check passes.

What a failure state means

StateMeaningNext action
Host missingChrome cannot find or connect to the local Host.Install or repair the Host, restart all browser windows, then check again.
Update requiredThe Host answered, but its protocol is older than the extension requires.Install the current matching Host and restart Chrome.
ForbiddenThe Host registration does not allow this extension identity.Reinstall from the matching official candidate. Do not edit the manifest by hand.
Unsupported pageThe browser prevents capture on this surface.Use a normal web page. Internal pages and the Chrome Web Store cannot be clipped.
Consent requiredAn external destination is configured without current per-sink consent.Open Sync settings and review the fields before enabling it.
Saved locally, sync failedThe local copy exists, but the optional external request failed.Keep the local copy and retry sync. Do not capture again.

Uninstall

The signed package will provide a matching uninstall helper. It removes Chrome and Edge Host registration and deletes Clipplane's Notion and flomo credentials by default. Your notes directory and capture files remain untouched.

Do not include secrets in support reports.If setup still fails, follow the safe report checklist on the Support page. Remove personal paths and configuration values from diagnostic output.