{
  "markdown": "# teamshared (Cursor plugin)\n\nRegisters the teamshared MCP server, the recall-first memory rule, and two\nCursor hooks (`postToolUse` for failed test/lint/shell, `preCompact` for a\nshort session summary). Nothing else — no skills, slash commands, extra\nhooks, or extra agents.\n\nThe MCP server itself lives in [`xhad/teamshared`](https://github.com/xhad/teamshared)\nand is hosted at [teamshared.com](https://teamshared.com).\n\n| Component | Purpose |\n|---|---|\n| `mcp.json` | Registers `https://teamshared.com/mcp` (URL only; Cursor OAuth Connect) |\n| `rules/teamshared.mdc` | Lean always-on fetch/store loop (`alwaysApply`); tool encyclopedia lives in `memory_tools_catalog` |\n| `hooks/` | Two Cursor hooks only: `postToolUse` (failed test/lint/shell) and `preCompact` |\n| `clients/` | Copy-paste protocol + MCP examples for non-Cursor harnesses (not loaded by Cursor) |\n\n## Install\n\n### From git marketplace (recommended)\n\n1. **Settings → Plugins → Add marketplace** → paste `https://github.com/teamshared-ai/teamshared-plugin`\n2. Run **`/add-plugin teamshared`** or enable **teamshared** under Settings → Plugins\n3. **Settings → Tools & MCP → teamshared → Connect** (email + one-time code, same as the console)\n\nCloud and Grok Bot agents inherit that account-level Connect. Installing the\nplugin registers `https://teamshared.com/mcp` — you only click **Connect**.\nDo not paste a URL or token into the plugin `mcp.json`.\n\nSee [MARKETPLACE.md](MARKETPLACE.md) for the official Marketplace publish checklist.\n\n### cursor.directory listing\n\nSubmit **this** repo at [cursor.directory/plugins/new](https://cursor.directory/plugins/new):\n\n```\nhttps://github.com/teamshared-ai/teamshared-plugin\n```\n\nDo not submit the old `xhad/teamshared-cursor` redirect. Root `plugin.json` and\n`.mcp.json` are the Open Plugins / directory discovery files; Cursor install\nstill uses `.cursor-plugin/` and `mcp.json`.\n\nReady-to-paste listing description:\n\n```\nTeamShared is hosted MCP plus the recall-first memory rule and two Cursor\nhooks (failed test/lint/shell + preCompact). No skills, slash commands, or\nextra agents.\n\nInstall in Cursor:\n1. Settings → Plugins → Add marketplace\n2. Paste https://github.com/teamshared-ai/teamshared-plugin\n3. /add-plugin teamshared\n4. Settings → Tools & MCP → teamshared → Connect (email + one-time code)\n\nCloud and Grok Bot agents inherit that Connect.\n```\n\n### From this repo (folder or symlink)\n\n**Add plugins from folder** needs a marketplace catalog in the selected\ndirectory. Select **this repo root** (it ships `.cursor-plugin/marketplace.json`\nwith `\"source\": \"./\"`).\n\nThen enable the plugin, reload the window, and **Connect**.\n\nFor local iteration without the folder picker:\n\n```bash\nln -sf \"$(pwd)\" ~/.cursor/plugins/local/teamshared\n```\n\n## Setup\n\n1. **Connect with email/OTP** — **Settings → Tools & MCP → teamshared → Connect**.\n   Cursor opens a browser; sign in with the same email + one-time code as the\n   web console (`/app`). The plugin already shipped the server URL; do not add\n   headers or a `tsk_*` token to the plugin `mcp.json`.\n2. **Cloud / Grok Bot** — they inherit that account-level Cursor Connect. After\n   the one-time Connect, every cloud agent for that user gets TeamShared.\n3. **Developer: Reload Window** — confirm **Settings → MCP** shows `teamshared` enabled.\n\nIf you previously added `https://teamshared.com/mcp` by hand, remove that\nmanual entry so you do not get two `teamshared` servers.\n\nDurable backup: one org `tsk_` on the MCP headers (`Authorization: Bearer tsk_…`)\nfor CI and other harnesses — not in the plugin `mcp.json`. Mint keys under\n`/app/keys`.\n\n## What you get\n\n- **MCP tools**: `memory_recall`, `memory_remember`, `memory_session_*`, etc.\n  (registered by `mcp.json` when the plugin is installed).\n- **Rule**: injects the recall-first protocol on every agent turn, and points\n  teammates to the web console (`/app`) for human actions.\n- **Two hooks only**: `postToolUse` appends a short episodic fact when a\n  Shell test/lint/command fails (command + error tail, secrets stripped).\n  `preCompact` writes a short session summary through `context_commit`.\n  Both reuse the existing Connect session — no `tsk_` in `mcp.json`.\n\nStill no skills, slash commands, extra agents, or extra hooks.\n\n## Other clients\n\nSee [`clients/`](clients/) for Hermes, Claude Desktop, and protocol markdown.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 4400,
  "sha": "e4d01d12b2a35f7b4e2fe66abc54ab81757acab59d4bd1d49a00e4a3240f2610",
  "repo_slug": "teamshared-ai/teamshared-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_xhad_teamshared_362af2c4/readme"
}