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.

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.