gossipcat 0.4.1 → 0.4.3

package/README.md

@@ -12,6 +12,7 @@
   <a href="https://github.com/gossipcat-ai/gossipcat-ai/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License" /></a>
   <a href="#quickstart"><img src="https://img.shields.io/badge/node-22%2B-green" alt="Node 22+" /></a>
   <a href="https://github.com/gossipcat-ai/gossipcat-ai/stargazers"><img src="https://img.shields.io/github/stars/gossipcat-ai/gossipcat-ai?style=social" alt="GitHub stars" /></a>
+  <a href="https://socket.dev/npm/package/gossipcat"><img src="https://badge.socket.dev/npm/package/gossipcat/0.4.2" alt="Socket Score" /></a>
 </p>
 
 <p align="center">
@@ -168,8 +169,7 @@ Both types participate equally in consensus, cross-review, and skill development
 ### One-liner
 
 ```bash
-npm install -g https://github.com/gossipcat-ai/gossipcat-ai/releases/latest/download/gossipcat.tgz && \
-claude mcp add gossipcat -s user -- gossipcat
+npm install -g gossipcat && claude mcp add gossipcat -s user -- gossipcat
 ```
 
 Restart Claude Code. Then in any project, ask:
@@ -185,8 +185,7 @@ Add to `~/.claude/mcp_settings.json`:
 {
   "mcpServers": {
     "gossipcat": {
-      "command": "gossipcat",
-      "args": ["mcp"]
+      "command": "gossipcat"
     }
   }
 }
@@ -199,7 +198,7 @@ Or project-local in `.mcp.json`:
   "mcpServers": {
     "gossipcat": {
       "command": "npx",
-      "args": ["gossipcat", "mcp"]
+      "args": ["gossipcat"]
     }
   }
 }
@@ -209,7 +208,7 @@ Or project-local in `.mcp.json`:
 
 Claude Code will call `gossip_setup()` to scaffold `.gossip/config.json` and your agent team. First-run bootstrap also writes the dispatch rules and tool catalog so Claude Code knows how to use gossipcat — no manual config needed.
 
-Gossipcat ships from **[GitHub Releases](https://github.com/gossipcat-ai/gossipcat-ai/releases)**, not the npm registry. The install URL above always points at the latest release. `npm` downloads the tarball directly, installs it globally, and drops a `gossipcat` binary on your `PATH` — no `npm publish` involved.
+Gossipcat is on **[npm](https://www.npmjs.com/package/gossipcat)** and **[GitHub Releases](https://github.com/gossipcat-ai/gossipcat-ai/releases)** — both carry the same bundle. `npm install -g gossipcat` pulls from the registry and is the shortest path; the GitHub release URL is useful when you want to pin to a specific tarball (see [Alternative install paths](#alternative-install-paths) below). Either way, npm drops a `gossipcat` binary on your `PATH`.
 
 ### What the install ships
 
@@ -222,15 +221,20 @@ Gossipcat ships from **[GitHub Releases](https://github.com/gossipcat-ai/gossipc
 
 ### Alternative install paths
 
-**Pin to a specific version:**
+**Pin to a specific npm version:**
+```bash
+npm install -g gossipcat@0.4.1
+```
+
+**Pin to a specific GitHub release tarball** (version-locked, bypasses npm registry):
 ```bash
-npm install -g https://github.com/gossipcat-ai/gossipcat-ai/releases/download/v0.1.1/gossipcat-0.1.1.tgz
+npm install -g https://github.com/gossipcat-ai/gossipcat-ai/releases/download/v0.4.1/gossipcat-0.4.1.tgz
 ```
 
 **Project-local install** (each project gets its own gossipcat):
 ```bash
 cd your-project
-npm install --save-dev https://github.com/gossipcat-ai/gossipcat-ai/releases/latest/download/gossipcat.tgz
+npm install --save-dev gossipcat
 ```
 The postinstall writes `.mcp.json` to your project root. Open Claude Code in that directory and gossipcat connects automatically — no `claude mcp add` needed.
 
@@ -245,9 +249,9 @@ claude mcp add gossipcat -s user -- node "$PWD/dist-mcp/mcp-server.js"
 
 ### Upgrading
 
-Re-run the one-liner — npm will fetch the latest release tarball and replace the installed version:
+Re-run the install — npm will fetch the latest version and replace the installed binary:
 ```bash
-npm install -g https://github.com/gossipcat-ai/gossipcat-ai/releases/latest/download/gossipcat.tgz
+npm install -g gossipcat@latest
 ```
 Or in-session, ask Claude Code: *"Check for gossipcat updates"* — the `gossip_update` tool fetches the latest release notes and applies the upgrade with your confirmation.
 
@@ -569,7 +573,7 @@ Check `~/.gossip/mcp.log` (or `<your-project>/.gossip/mcp.log`) for the boot log
 - **Conflicting `.gossip/relay.pid`** from a crashed previous boot — delete it and restart Claude Code
 - **`GOSSIPCAT_PORT` set to a port already in use** — unset the env var or pick a free port
 
-### "Boot says 'No gossip.agents.json found' and nothing happens"
+### "Boot says 'No .gossip/config.json found' and nothing happens"
 This was a critical bug in v0.1.0 — fixed in v0.1.1. Upgrade with the install one-liner above. v0.1.1+ boots in degraded mode (dashboard + relay only) so you can run `gossip_setup` from inside Claude Code.
 
 ### "Agents keep returning empty findings"