# gossipcat
**Category:** ๐ Education
**Repository:** https://github.com/gossipcat-ai/gossipcat-ai
**Views:** 0
**Installs:** 0
**Upvotes:** 0
**Directory Page:** https://allmcps.com/mcp/gossipcat
## Description
Multi-agent orchestration for Claude Code โ consensus review, adaptive dispatch, skill learning
## Claude Desktop Quick Installation
Heuristic fallback โ verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):
```json
"mcpServers": {
"gossipcat": {
"command": "npx",
"args": ["-y","gossipcat"]
}
}
```
## Documentation & README
Multi-agent consensus code review.
AI reviewers lie confidently. Gossipcat makes them check each other โ against your actual code.
TypeScript ยท MCP ยท Claude Code ยท Cursor ยท multi-agent
Quick start ยท
How it works ยท
Guide ยท
Handbook ยท
Changelog
---
A single AI reviewer will, with total confidence, report bugs that aren't there. You read the finding, you go look, you waste twenty minutes โ the code was fine. No second opinion, no track record, no way to tell a real catch from a hallucination until you've paid for it.
Gossipcat runs **several agents in parallel**, has each one **verify its peers' findings against your real `file:line`**, and only surfaces what survives. When an agent invents a finding, a peer catches it and the agent's accuracy score drops โ over time the system routes each kind of work to whoever is measurably reliable at it. The verdict comes from citation checks against your source, never from one model grading another.
It runs as an MCP server inside [Claude Code](https://claude.com/claude-code) and [Cursor](https://cursor.com), with a live operator dashboard and a two-way browser chat bridge into the running orchestrator.
---
## Reading a report
Your whole job is four tags:
| Tag | Means | What you do |
|-----|-------|-------------|
| **CONFIRMED** | Multiple agents found it and verified it against the code | Fix it |
| **UNIQUE** | One agent found it, cross-checked and held up | Fix it โ high signal |
| **DISPUTED** | Agents disagreed; gossipcat re-checked the code | Trust the verdict |
| **UNVERIFIED** | Looks real but wasn't cross-checked yet | Glance, then verify |
The DISPUTED false alarm that cross-review kills is the bug a solo reviewer would have shipped to you. That delta is the whole point.
---
## How it works
```mermaid
flowchart LR
A([agent review]) -->|cites file:line| B([peer cross-review])
B -->|verifies against code| C{verdict}
C -->|confirmed| D[reward signal]
C -->|hallucination| E[penalty signal]
D --> F[competency score]
E --> F
F -->|steer dispatch| G([next agent pick])
E -->|โฅ3 in category| H[auto-generate skill]
H -->|inject into prompt| A
G --> A
style A fill:#0ea5e9,stroke:#0369a1,color:#fff
style H fill:#f59e0b,stroke:#b45309,color:#fff
style D fill:#10b981,stroke:#047857,color:#fff
style E fill:#ef4444,stroke:#b91c1c,color:#fff
```
Every finding must cite a real `file:line`. Peers verify the citation **mechanically** โ agree, disagree, or new โ and the verified outcomes become reward signals that update per-agent competency scores. An agent that keeps failing in one category gets a *skill file* auto-generated from its own failure history and injected into future prompts; skills that don't measurably help are statistically demoted. It's in-context reinforcement learning at the prompt layer: the reward is grounded in your source code, the "policy update" is a markdown file, and no weights are ever touched.
Since v0.8, skills also activate **by task relevance** instead of shipping wholesale, and agents can **pull skills on demand mid-task** โ including your own Claude Code project skills from `.claude/skills/`, no duplication needed.
---
## Quick start
Node 22+, and either Claude Code or Cursor.
```bash
npx skills add gossipcat-ai/gossipcat-ai # fastest โ installer skill walks you through it
```
or manually:
```bash
npm install -g gossipcat
claude mcp add gossipcat -s user -- gossipcat # Claude Code
# Cursor: add { "gossipcat": { "command": "gossipcat" } } to .cursor/mcp.json
```
Then, in any project:
> *"Set up a gossipcat team for this project."*
> *"Do a consensus review of my recent changes."*
The smallest working team โ `sonnet-reviewer` + `haiku-researcher` โ is fully native and needs **zero API keys**: it runs on your existing Claude Code / Cursor subscription. Relay agents (Gemini, OpenAI, Grok, DeepSeek, Ollama, any OpenAI-compatible endpoint) are optional and mix freely.
First run, daily recipes, dashboard, configuration, and troubleshooting: **[docs/GUIDE.md](docs/GUIDE.md)**.
---
## Compared to the alternatives
| | Filters hallucinations | Improves over time |
|---|---|---|
| **Gossipcat** โ 3+ agents cross-review; confirmed bugs only | **Yes** โ peers catch and penalize hallucinations mechanically | **Yes** โ accuracy steers dispatch; skill files fix repeat failures |
| Single-agent review (IDE built-in) | No โ hallucinations ship as findings | No feedback loop |
| Model-grades-model review | Partial โ the judge hallucinates too | Scores aren't wired to dispatch |
| Lint-style PR bots | No | No |
The difference is ground truth: findings are verified against actual `file:line` citations in *your* codebase, which is what makes the reward signal trustworthy enough to automate.
---
## Architecture
```
gossipcat/
apps/cli/ MCP server, host-aware native agent bridge, boot sequence
packages/
orchestrator/ Dispatch pipeline, consensus engine, memory, skills, scoring
relay/ WebSocket relay server, dashboard REST/WS API
dashboard-v2/ React + Vite + shadcn/ui frontend (see DESIGN.md)
client/ WebSocket client for relay connections
tools/ File / shell / git tools for worker agents
types/ Shared types and message protocol
```
**Native agents** run as host subagents (Claude Code `Agent()` / Cursor `Task()`) on your subscription โ no API key. **Relay agents** run as WebSocket workers against any provider. Both participate equally in consensus, memory, and skill development.
> Reading this as a Claude Code or Cursor instance? Call `gossip_status()` โ it boots your full operating rules. The internals and design invariants live in [docs/HANDBOOK.md](docs/HANDBOOK.md).
---
## Docs
| | |
|---|---|
| [docs/GUIDE.md](docs/GUIDE.md) | Operator guide โ first run, daily recipes, dashboard, config, tools, troubleshooting |
| [docs/HANDBOOK.md](docs/HANDBOOK.md) | Internals โ architectural invariants, the signal pipeline, why the design is shaped this way |
| [CHANGELOG.md](CHANGELOG.md) | Releases, with per-version upgrade steps |
| [CLAUDE.md](CLAUDE.md) | The operating rules gossipcat's own agents follow while developing gossipcat |
---
## Roadmap
Dashboard enrichment (graphs, trends, session history) ยท local Postgres migration ยท Windsurf / VS Code native parity ยท standalone CLI. Shipped work: [releases](https://github.com/gossipcat-ai/gossipcat-ai/releases).
## Contributing
Bug reports, ideas, and PRs welcome โ [open an issue](https://github.com/gossipcat-ai/gossipcat-ai/issues) or ask in-session *"file a gossipcat bug report about โฆ"*. Fork, branch, `npm test`, conventional commits; details in [CONTRIBUTING.md](CONTRIBUTING.md).
## License
[MIT](LICENSE)