@flaggr/plugin

The Flaggr plugin for Claude Code and Codex. It connects your assistant to Flaggr's hosted MCP server, https://flaggr.dev/mcp (OAuth sign-in, no tokens to copy), and adds Flaggr's agent skills: guided setup, flags, rollout plans with browser-vitals guardrails, alert incidents, team and member administration, browser analytics, and error and crash reporting. In Codex it also adds the Flaggr app entry.

Install

From a terminal, with Node.js 18 or later:

npx @flaggr/plugin            # every client on your PATH (claude, codex)
npx @flaggr/plugin --claude   # Claude Code only
npx @flaggr/plugin --codex    # Codex only
npx @flaggr/plugin --dry-run  # print what would run, change nothing

The installer only drives each client's own CLI. It never opens a browser: you sign in from the client afterwards.

Claude Code

Inside Claude Code, add Flaggr's marketplace:

/plugin marketplace add https://flaggr.dev/plugins/marketplace.json

Then install the plugin:

/plugin install flaggr@flaggr

Claude Code downloads the plugin with npm, so this route also needs Node.js 18 or later, with npm on the PATH Claude Code sees. Without Node.js, add just the MCP server: claude mcp add --transport http --scope user flaggr https://flaggr.dev/mcp.

npx @flaggr/plugin --claude does the same from a terminal, for your user: claude plugin marketplace add https://flaggr.dev/plugins/marketplace.json, then claude plugin install flaggr@flaggr --scope user. Run again, it refreshes the marketplace and updates the plugin.

Then start a new session (or run /reload-plugins), run /mcp, select plugin:flaggr:flaggr (the Flaggr plugin's server) and choose Authenticate.

Updates: inside Claude Code, choose Update now under /plugin → Installed → flaggr, or run /plugin marketplace update flaggr, which refreshes the catalog and updates the plugins installed from it. From a terminal, run claude plugin update flaggr@flaggr (or npx @flaggr/plugin --claude again); in a terminal, claude plugin marketplace update flaggr only refreshes the catalog. Then run /reload-plugins or restart Claude Code. To get updates automatically, turn on auto-update under /plugin → Marketplaces → flaggr.

Codex

npx @flaggr/plugin --codex

The installer writes a one-plugin catalog to ~/.flaggr/codex-marketplace, registers that directory as a Codex marketplace, and runs codex plugin add flaggr@flaggr. Keep that directory: Codex reads the catalog from there. If you already have a marketplace named flaggr, it installs from that one instead and writes nothing.

• Codex 0.143 or later installs @flaggr/plugin from npm, and picks up a new version the next time the Codex app or TUI starts.
• Codex 0.131–0.142 can't install plugins from npm, so the catalog gets a local copy of the plugin. Run npx @flaggr/plugin --codex again to update it.
• Older versions can't install plugins from the command line. Upgrade Codex first.

Then open Codex, sign in to Flaggr when prompted (Codex runs the bundled flaggr-setup skill on install), and choose Explore → Flaggr → Pin to sidebar.

Other assistants

Any MCP client can use the hosted server directly: https://flaggr.dev/mcp (streamable HTTP, OAuth). Step-by-step setup for Claude, ChatGPT, Cursor, VS Code and others is at flaggr.dev/connect.

Docs: Agent Skills & Plugins

License

MIT. See LICENSE.