cover-plugin

Official fail-closed Cover privacy plugin for Pi and Oh My Pi

Packages

Package details

extension

Install cover-plugin from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:cover-plugin
Package
cover-plugin
Version
0.1.0
Published
Aug 24, 2026
Downloads
139/mo · 139/wk
Author
davidcarliez
License
Apache-2.0
Types
extension
Size
14 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./index.js"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Cover Plugin for Pi and Oh My Pi

cover-plugin connects Cover to the Pi and Oh My Pi model-provider systems. Cover remains the local privacy boundary; the plugin only manages provider routing, health, and commands.

Install Cover first, then install the extension:

pi install npm:cover-plugin

# Oh My Pi: install directly from npm
omp plugin install cover-plugin

# Or use the Cover marketplace
omp plugin marketplace add DavidCarliez/cover
omp plugin install cover-plugin@cover

Inside Pi or Oh My Pi, choose exactly which providers must use Cover:

/cover providers openai-codex,deepseek=/
/cover on
/cover doctor

OpenAI-family providers default to the /v1 proxy path. Use =/ for providers whose transport supplies its own API path. Custom paths are also supported, for example router=/api/v1.

Commands: /cover status, /cover on, /cover off, /cover providers, /cover start, /cover stop, /cover doctor, and /cover monitor.

When protection is enabled, configured providers remain pointed at the local proxy if Cover stops. Their requests fail locally instead of bypassing Cover. State is stored in ~/.config/cover/harness.json with private permissions.

Environment overrides:

  • COVER_BIN: path to the Cover executable.
  • COVER_BASE_URL: local proxy URL.
  • COVER_PROVIDERS: comma-separated provider routes.
  • COVER_HARNESS_DISABLED: start with integration disabled.
  • COVER_HARNESS_STATE: alternate state file.