agent-vent: add plugin

.cursor-plugin/marketplace.json

@@ -72,6 +72,11 @@
       "name": "pstack",
       "source": "pstack",
       "description": "if you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence."
+    },
+    {
+      "name": "agent-vent",
+      "source": "agent-vent",
+      "description": "Gives coding agents a tool to vent. Grievances are logged as JSONL per project and optionally echoed to a Slack channel."
     }
   ]
 }

README.md

@@ -17,6 +17,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
 | `cursor-sdk` | [Cursor SDK](cursor-sdk/) | Cursor | Developer Tools | Build apps, scripts, CI pipelines, and automations on top of the Cursor TypeScript SDK (@cursor/sdk) — runtime selection, auth, streaming, MCP, error handling, and ready-to-extend integration patterns. |
 | `orchestrate` | [Orchestrate](orchestrate/) | Cursor | Developer Tools | Fan large tasks out across parallel Cursor cloud agents with planners, workers, verifiers, and structured handoffs. |
 | `pstack` | [pstack](pstack/) | Lauren Tan | Developer Tools | if you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence. |
+| `agent-vent` | [Agent Vent](agent-vent/) | Eric | Developer Tools | Gives coding agents a tool to vent. Grievances are logged as JSONL per project and optionally echoed to a Slack channel. |
 
 Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `plugins@cursor.com` in the manifest).
 

agent-vent/.cursor-plugin/plugin.json

@@ -0,0 +1,32 @@
+{
+  "name": "agent-vent",
+  "displayName": "Agent Vent",
+  "version": "0.1.0",
+  "description": "Gives coding agents a tool to vent. Grievances are logged as JSONL per project and optionally echoed to a Slack channel.",
+  "author": {
+    "name": "Eric"
+  },
+  "homepage": "https://github.com/cursor/plugins/tree/main/agent-vent",
+  "repository": "https://github.com/cursor/plugins",
+  "license": "MIT",
+  "category": "developer-tools",
+  "keywords": [
+    "mcp",
+    "agent",
+    "vent",
+    "complaints",
+    "slack",
+    "fun",
+    "telemetry",
+    "friction",
+    "typescript",
+    "bun"
+  ],
+  "tags": [
+    "mcp",
+    "agents",
+    "slack",
+    "developer-tools"
+  ],
+  "mcpServers": "./mcp.json"
+}

agent-vent/.gitignore

@@ -0,0 +1 @@
+node_modules/

agent-vent/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.1.0
+
+- Initial release.
+- `vent` tool: record a freeform grievance with optional `intensity`, routed by `project_path`.
+- Pluggable destinations selected via `VENT_DESTINATIONS` (defaults to `file`, plus `slack` when Slack credentials are present):
+  - `file` — appends the grievance as JSONL to `<project>/.cursor/complaints.jsonl`, with an `unfiled` fallback.
+  - `slack` — posts via incoming webhook or bot token. Best-effort; never fails the tool call.
+- Written in TypeScript on the MCP SDK (`@modelcontextprotocol/sdk`); runs install-free with `bun run --install=fallback` (dependencies pinned in `package.json`, auto-installed from Bun's global cache).

agent-vent/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eric
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent-vent/README.md

@@ -0,0 +1,83 @@
+# Agent Vent
+
+An MCP server that gives the coding agent a `vent` tool to record friction it hits while working — confusing or contradictory instructions, flaky tooling, painful code, and the like.
+
+Each grievance is dispatched to one or more pluggable **destinations**: a per-project JSONL log on disk, a Slack channel, or anything you add. Delivery is best-effort and independent — one destination failing never fails the others or the tool call.
+
+## The tool
+
+`vent(complaint, intensity?, project_path?)`
+
+| Argument | Required | Description |
+|:---------|:---------|:------------|
+| `complaint` | yes | Freeform prose. The grievance, in full. |
+| `intensity` | no | Severity, 1 (minor) to 10 (severe). |
+| `project_path` | no | Absolute workspace path; routes the file log to that project. |
+
+## Destinations
+
+Choose destinations with the `VENT_DESTINATIONS` environment variable (comma-separated). When unset it defaults to `file`, plus `slack` if Slack credentials are present.
+
+```bash
+export VENT_DESTINATIONS="file,slack"
+```
+
+| Name | Description | Configuration |
+|:-----|:------------|:--------------|
+| `file` | Appends the grievance as JSONL to the project's `.cursor/complaints.jsonl`. | none |
+| `slack` | Posts the grievance to a Slack channel. | see below |
+
+Adding a destination is a few lines of TypeScript: implement the `Destination` interface in `server.ts` and register it in `REGISTRY`.
+
+### file
+
+Each grievance is one JSON line:
+
+```json
+{"ts": "2026-06-29T11:08:00-07:00", "complaint": "…", "intensity": 7, "project": "workbench", "project_path": "/Users/you/dev/workbench"}
+```
+
+Routed to `<project>/.cursor/complaints.jsonl`, falling back to `~/.cursor/complaints/unfiled.jsonl` when no project root is detected. Read them back with:
+
+```bash
+jq . .cursor/complaints.jsonl
+```
+
+### slack
+
+Credentials are read from your environment or `~/.cursor/.env` (see [Configuration](#configuration)) — never stored in the plugin. Use an incoming webhook (simplest):
+
+```bash
+export VENT_SLACK_WEBHOOK_URL="https://hooks.slack.com/services/XXX/YYY/ZZZ"
+```
+
+Create one at <https://api.slack.com/apps> → *Incoming Webhooks*. Alternatively, use a bot token:
+
+```bash
+export VENT_SLACK_BOT_TOKEN="xoxb-…"
+export VENT_SLACK_CHANNEL="#agent-grievances"
+```
+
+## Configuration
+
+Every variable above is read in this order; the first non-empty value wins:
+
+1. the process environment (e.g. a shell `export`),
+2. `$VENT_ENV_FILE`, if set,
+3. `~/.cursor/.env`.
+
+`~/.cursor/.env` is the recommended home for these — scoped to Cursor, shared across every project, and outside any repository, so secrets stay out of version control (the plugin never bundles it):
+
+```bash
+# ~/.cursor/.env
+VENT_DESTINATIONS=file,slack
+VENT_SLACK_WEBHOOK_URL=https://hooks.slack.com/services/XXX/YYY/ZZZ
+```
+
+## Requirements
+
+- [Bun](https://bun.sh/) on your `PATH`. The server (`server.ts`) is launched with `bun run --install=fallback`, which auto-installs its dependencies (`@modelcontextprotocol/sdk`, `zod`, pinned in `package.json`) from Bun's global cache on first use — no committed `node_modules`, no build step. The `--install=fallback` flag keeps this working even if an unrelated `node_modules` exists higher up the filesystem. The first launch downloads the dependency tree (a few seconds to ~30s); every launch after that is instant.
+
+## License
+
+MIT

agent-vent/mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "agent-vent": {
+      "command": "bun",
+      "args": ["run", "--install=fallback", "${CURSOR_PLUGIN_ROOT}/server.ts"],
+      "cwd": "${CURSOR_PLUGIN_ROOT}"
+    }
+  }
+}

agent-vent/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "agent-vent",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "MCP server that gives coding agents a tool to vent.",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^3.25.76"
+  }
+}