cursor__plugins/agent-vent

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:

{"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:

jq . .cursor/complaints.jsonl

Requirements

• Bun on your PATH. The server (server.ts) is launched with bun run, 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. bunfig.toml sets install.auto = "fallback" so this works 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.

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):

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:

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