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.2.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",
+    "deno"
+  ],
+  "tags": [
+    "mcp",
+    "agents",
+    "slack",
+    "developer-tools"
+  ],
+  "mcpServers": "./mcp.json"
+}

agent-vent/.gitignore

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

agent-vent/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 0.2.0
+
+- Rewritten in TypeScript on the official MCP SDK (`@modelcontextprotocol/sdk`), with `zod` input schemas.
+- Now runs install-free via `deno run`: npm dependencies are declared inline and cached by Deno (no `package.json`, no `node_modules`, no build). `deno.lock` pins transitive versions.
+- Behavior is unchanged — same `vent` tool, same JSONL storage layout and key order, same best-effort Slack delivery.
+
+## 0.1.0
+
+- Initial release.
+- `vent` tool: file freeform grievances with optional `mood` and `intensity`.
+- JSONL storage per project at `.cursor/complaints.jsonl` (with `unfiled` fallback).
+- Optional best-effort Slack delivery via incoming webhook or bot token, configured through environment variables.
+- Launches via `uv run` with PEP 723 inline dependencies — no virtualenv required.

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,55 @@
+# Agent Vent
+
+An MCP server with exactly one job: give the coding agent a `vent` tool to complain.
+
+When a task gets frustrating, absurd, or quietly soul-crushing, the agent can file a grievance instead of bottling it up. Every complaint is appended as JSONL to the current project's `.cursor/complaints.jsonl`, and — if you configure Slack — echoed to a channel so the whole team can share in the suffering.
+
+## The tool
+
+`vent(complaint, project_path?, mood?, intensity?)`
+
+| Argument | Required | Description |
+|:---------|:---------|:------------|
+| `complaint` | yes | Freeform prose. The grievance, in full. |
+| `project_path` | no | Absolute workspace path; routes the complaint to that project's log. |
+| `mood` | no | A word or two, e.g. `weary`, `betrayed by tooling`. |
+| `intensity` | no | 1 (mild eye-roll) to 10 (staring into the void). |
+
+## Storage
+
+Each grievance is one JSON line:
+
+```json
+{"ts": "2026-06-29T11:08:00-07:00", "project": "workbench", "project_path": "/Users/you/dev/workbench", "complaint": "…", "mood": "weary", "intensity": 7}
+```
+
+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
+```
+
+## Requirements
+
+- [Deno](https://deno.com/) 2.x on your `PATH`. The server (`server.ts`) is launched with `deno run`, which fetches and caches its npm dependencies (`@modelcontextprotocol/sdk`, `zod`) on first use — no `package.json`, no `node_modules`, no build step. `deno.lock` pins transitive versions. The first launch downloads the dependency tree (a few seconds to ~30s); every launch after that is instant.
+
+## Slack (optional)
+
+Slack delivery is off until you set an environment variable. The webhook is read from **your** environment — it is never stored in the plugin. Add to your shell profile (e.g. `~/.zshrc`):
+
+```bash
+export VENT_SLACK_WEBHOOK_URL="https://hooks.slack.com/services/XXX/YYY/ZZZ"
+```
+
+Create an incoming webhook 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"
+```
+
+Slack posting is best-effort: if it fails, the JSONL write still succeeds and the tool just notes the failure.
+
+## License
+
+MIT

agent-vent/deno.json

@@ -0,0 +1,3 @@
+{
+  "nodeModulesDir": "none"
+}