TeamShared

teamshared (Cursor plugin)

Registers the teamshared MCP server, the recall-first memory rule, and two Cursor hooks (postToolUse for failed test/lint/shell, preCompact for a short session summary). Nothing else — no skills, slash commands, extra hooks, or extra agents.

The MCP server itself lives in xhad/teamshared and is hosted at teamshared.com.

Component	Purpose
mcp.json	Registers https://teamshared.com/mcp (URL only; Cursor OAuth Connect)
rules/teamshared.mdc	Lean always-on fetch/store loop (alwaysApply); tool encyclopedia lives in memory_tools_catalog
hooks/	Two Cursor hooks only: postToolUse (failed test/lint/shell) and preCompact
clients/	Copy-paste protocol + MCP examples for non-Cursor harnesses (not loaded by Cursor)

Install

From git marketplace (recommended)

1. Settings → Plugins → Add marketplace → paste https://github.com/teamshared-ai/teamshared-plugin
2. Run /add-plugin teamshared or enable teamshared under Settings → Plugins
3. Settings → Tools & MCP → teamshared → Connect (email + one-time code, same as the console)

Cloud and Grok Bot agents inherit that account-level Connect. Installing the plugin registers https://teamshared.com/mcp — you only click Connect. Do not paste a URL or token into the plugin mcp.json.

See MARKETPLACE.md for the official Marketplace publish checklist.

cursor.directory listing

Submit this repo at cursor.directory/plugins/new:

https://github.com/teamshared-ai/teamshared-plugin

Do not submit the old xhad/teamshared-cursor redirect. Root plugin.json and .mcp.json are the Open Plugins / directory discovery files; Cursor install still uses .cursor-plugin/ and mcp.json.

Ready-to-paste listing description:

TeamShared is hosted MCP plus the recall-first memory rule and two Cursor
hooks (failed test/lint/shell + preCompact). No skills, slash commands, or
extra agents.

Install in Cursor:
1. Settings → Plugins → Add marketplace
2. Paste https://github.com/teamshared-ai/teamshared-plugin
3. /add-plugin teamshared
4. Settings → Tools & MCP → teamshared → Connect (email + one-time code)

Cloud and Grok Bot agents inherit that Connect.

From this repo (folder or symlink)

Add plugins from folder needs a marketplace catalog in the selected directory. Select this repo root (it ships .cursor-plugin/marketplace.json with "source": "./").

Then enable the plugin, reload the window, and Connect.

For local iteration without the folder picker:

ln -sf "$(pwd)" ~/.cursor/plugins/local/teamshared

Setup

1. Connect with email/OTP — Settings → Tools & MCP → teamshared → Connect. Cursor opens a browser; sign in with the same email + one-time code as the web console (/app). The plugin already shipped the server URL; do not add headers or a tsk_* token to the plugin mcp.json.
2. Cloud / Grok Bot — they inherit that account-level Cursor Connect. After the one-time Connect, every cloud agent for that user gets TeamShared.
3. Developer: Reload Window — confirm Settings → MCP shows teamshared enabled.

If you previously added https://teamshared.com/mcp by hand, remove that manual entry so you do not get two teamshared servers.

Durable backup: one org tsk_ on the MCP headers (Authorization: Bearer tsk_…) for CI and other harnesses — not in the plugin mcp.json. Mint keys under /app/keys.

What you get

• MCP tools: memory_recall, memory_remember, memory_session_*, etc. (registered by mcp.json when the plugin is installed).
• Rule: injects the recall-first protocol on every agent turn, and points teammates to the web console (/app) for human actions.
• Two hooks only: postToolUse appends a short episodic fact when a Shell test/lint/command fails (command + error tail, secrets stripped). preCompact writes a short session summary through context_commit. Both reuse the existing Connect session — no tsk_ in mcp.json.

Still no skills, slash commands, extra agents, or extra hooks.

Other clients

See clients/ for Hermes, Claude Desktop, and protocol markdown.

License

MIT — see LICENSE.