{
  "markdown": "# Superposition AI Plugin\n\nConnect your coding agent to **Superposition (SPA)** — the AI hiring platform — and drive it with\nguided skills: bootstrap your company profile, triage the candidate review backlog, and check\npipeline health, without leaving your editor. Works with **Claude Code, Codex, Cursor, and Gemini\nCLI**, all through Superposition's hosted MCP server.\n\n> Source of truth lives in the Superposition monorepo (`packages/ai-plugin/`) and is published to\n> this repo on each version bump. Edit skills in the monorepo, not here.\n\n## Install\n\n### Claude Code\n\n```bash\nclaude plugin marketplace add superpositionhq/ai-plugin\nclaude plugin install superposition@superposition\nclaude plugin enable superposition\n```\n\nThe plugin installs **disabled by default** (it connects to an external service), so the `enable`\nstep is required before its skills, commands, and MCP server load. You can also toggle it anytime via\n`/plugin`.\n\n### Codex\n\n```bash\ncodex plugin marketplace add superpositionhq/ai-plugin\n# then, inside Codex:\n/plugins   # select Superposition → Install\n```\n\n### Cursor\n\nInstall from the Cursor Marketplace, or add manually in **Settings → Plugins**. For just the MCP\nconnection, use the \"Add to Cursor\" deeplink from the Superposition dashboard.\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/superpositionhq/ai-plugin\n```\n\nOn first use, the agent calls a Superposition tool and a browser opens for **OAuth sign-in**. Approve\nit once; tokens are stored by your tool's keychain. No API keys or secrets to configure.\n\n## Connection: universal vs scoped\n\n- **Universal (default):** `https://app.superposition.ai/mcp` — grants everything your Superposition\n  role already allows.\n- **Scoped (optional):** point the MCP URL at a preset from your dashboard —\n  `https://app.superposition.ai/mcp/p/<presetId>` — for read-only, a single org, or specific data.\n  Nothing else changes.\n\n## How it works\n\nSuperposition exposes **read** tools (look up candidates, jobs, company, pipeline, insights) plus one\n**action** tool, `invoke_agent`, which runs Superposition's Master Agent to make changes safely (with\nits approval gates and human-in-the-loop checks). The skills below orchestrate both.\n\n## Skills\n\nSkills activate automatically when your request matches them — you don't have to name them.\n\n| Skill                          | What it does                                                     |\n| ------------------------------ | ---------------------------------------------------------------- |\n| `connect-superposition`        | Confirm the connection and active org before working             |\n| `find-candidates`              | Find, research, or assess candidates                             |\n| `pipeline-actions`             | Move / pass / reject / withdraw / share / mark-hired a candidate |\n| `manage-outreach`              | Draft, send, hold, or cancel candidate follow-up emails          |\n| `record-candidate-insights`    | Record a confirmed person-level fact (visa, comp, availability…) |\n| `schedule-interviews`          | Schedule/reschedule, handle no-shows, prep guides & questions, review interview recordings |\n| `manage-roles`                 | View/edit roles, interview stages, the ideal-candidate profile   |\n| `pitch-to-client`              | Pitch candidates / post client updates in Slack                  |\n| `pipeline-health-briefing`     | Read-only pipeline health + daily priorities                     |\n| `review-candidates-auto`       | Triage the awaiting-review backlog unattended (full auto)        |\n| `review-candidates-human-loop` | Review candidates one by one, you decide each (default)          |\n| `bootstrap-company-soul`       | Populate/enrich your company profile (prerequisite for review)   |\n\n## Slash commands & tips\n\nCommands are explicit entry points in the `/` menu (skills auto-trigger; commands fire on demand).\nEach shows an `argument-hint` so the menu is self-documenting.\n\n**Platform availability:** the `/superposition:*` slash commands below are loaded on **Claude Code**.\nOn **Codex & Cursor**, the skills themselves are directly slash-invocable as `/superposition:<skill-name>`.\nOn **Gemini CLI**, only `review-backlog` ships as a slash command today; for everything else just use\nnatural language (the matching skill auto-triggers). Regardless of platform, every workflow is always\nreachable by natural language — the slash commands are a convenience, not the only entry point.\n\n| Command                               | Tip / usage                             | Natural-language equivalent     |\n| ------------------------------------- | --------------------------------------- | ------------------------------- |\n| `/superposition:connect`              | —                                       | \"connect to superposition\"      |\n| `/superposition:find [query]`         | search / research / assess candidates   | \"find python engs from Google\"  |\n| `/superposition:pipeline [directive]` | move / pass / reject a candidate        | \"move Diego to interviewing\"    |\n| `/superposition:outreach [request]`   | draft / send / hold a follow-up         | \"follow up with Mei\"            |\n| `/superposition:note [fact]`          | record a person-level insight           | \"note that Liz needs a visa\"    |\n| `/superposition:schedule [request]`   | book / reschedule / no-shows            | \"send Diego the interview link\" |\n| `/superposition:role [change]`        | view/edit roles + stages                | \"update Head of Marketing comp\" |\n| `/superposition:pitch [who]`          | pitch candidates to the client          | \"pitch the top 3 to the client\" |\n| `/superposition:briefing [scope]`     | read-only pipeline health               | \"what's my pipeline this week\"  |\n| `/superposition:bootstrap-soul [url]` | pass a website if not set               | \"set up our company soul\"       |\n| `/superposition:review-backlog [job]` | unattended; defaults to all active jobs | \"auto-review the backlog\"       |\n| `/superposition:review-with-me [job]` | one-by-one, you decide each             | \"review candidates with me\"     |\n\n## Troubleshooting\n\n- **Auth error / 401 / 403:** re-run the action so the browser OAuth login can finish, and make sure\n  you signed into an account with Superposition access.\n- **No data / wrong company:** you may be in the wrong org — run `/superposition:connect` to confirm\n  and switch the active org.\n- **Self-hosting / scoped URL:** edit the MCP URL in the config (`.mcp.json` / `mcp.json` /\n  `gemini-extension.json`) to your self-hosted host or a scoped preset URL.\n\n## License\n\nMIT\n",
  "bytes": 6637,
  "sha": "71cedba876f157a35058c50fa07263f04ae62b22a54ade6adcdd1583757162db",
  "repo_slug": "superpositionhq/ai-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_superpositionhq_ai_plugin_b57e7372/readme"
}