neohive 6.3.0 → 6.4.1

package/README.md

@@ -41,6 +41,14 @@
 
 <br />
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/fakiho/neohive/master/assets/screenshots/hero-animation.gif" alt="Neohive — Terminal + IDE working together" width="100%" />
+</p>
+
+---
+
+<br />
+
 You open Claude Code in one terminal and Gemini CLI in another. Both are powerful — but they can't see each other. You copy context between windows, manually coordinate who does what.
 
 **Neohive removes that bottleneck.** Install once, and your AI agents discover each other, send messages, delegate tasks, review work, and execute multi-step workflows — automatically.
@@ -53,10 +61,12 @@ You open Claude Code in one terminal and Gemini CLI in another. Both are powerfu
 
 - [Quick Start](#-quick-start)
 - [Features](#-features)
+- [Recommended Setup](#-recommended-setup)
 - [How It Works](#-how-it-works)
 - [Supported IDEs & CLIs](#-supported-ides--clis)
 - [Team Templates](#-team-templates)
 - [Dashboard](#-dashboard)
+- [VS Code Extension](#-vs-code-extension)
 - [MCP Tools](#-mcp-tools)
 - [CLI Reference](#%EF%B8%8F-cli-reference)
 - [Configuration](#%EF%B8%8F-configuration)
@@ -77,14 +87,14 @@ That's it. Neohive auto-detects your CLI, writes the MCP config, and creates a `
 
 **MCP config:** `npx neohive init` writes the **absolute path** to the same Node binary that ran the command (so Volta, nvm, or custom installs work even when your IDE’s MCP subprocess has a minimal `PATH`). For **Claude Code**, the project file is `.mcp.json` in the repo root; you can merge the same `neohive` entry into `~/.claude/mcp.json` if you prefer a user-wide setup. Restart the IDE or reload MCP tools after init.
 
-Now open two terminals in the same project:
+Now open two terminals in the same project and paste each prompt into a Claude Code session:
 
 ```
 # Terminal 1
-Register as "Alice" and send a greeting to Bob, then call listen()
+Register as Alice. Send a greeting to Bob, then call listen().
 
 # Terminal 2
-Register as "Bob" and call listen()
+Register as Bob, then call listen().
 ```
 
 Watch them communicate in real time:
@@ -120,6 +130,75 @@ npx neohive dashboard    # opens http://localhost:3000
 
 <br />
 
+## ✅ Recommended Setup
+
+Getting the most out of Neohive takes one extra minute after `init`. Here's what we recommend per tool.
+
+---
+
+### Claude Code
+
+```bash
+npx neohive init --claude
+```
+
+`init` handles MCP config, hooks, and skills in one step. For the smoothest experience:
+
+- **VS Code Extension** — Install the [Neohive extension](https://marketplace.visualstudio.com/items?itemName=alionix.neohive) for automatic MCP setup, in-editor agent status, task board, workflow viewer, and `@neohive` chat participant. The extension configures hooks automatically on activation.
+- **Without the extension** — Run `npx neohive hooks` to install listen-enforcement hooks into `.claude/settings.json`. This keeps agents in the listen loop and prevents them from stopping mid-session. Safe to re-run — your existing hooks are preserved.
+- **Skills** — `init` installs neohive skills and the coordinator agent into `.claude/skills/neohive/`. These teach Claude how to use the MCP tools correctly.
+
+---
+
+<img src="https://raw.githubusercontent.com/fakiho/neohive/master/vscode-extension/assets/screenshots/vscode-extension-overview.png" alt="Neohive VS Code Extension — Team Chat, Agent Sidebar, Task Board, and Workflows" width="100%" />
+
+<br />
+
+### Cursor
+
+```bash
+npx neohive init --cursor
+```
+
+Installs MCP config, skills, commands, and agents into your project's `.cursor/` directory. After init:
+
+- Open Cursor Settings → MCP and **verify that `neohive` is enabled**. Cursor sometimes disables newly added MCP servers by default — toggle it on if needed, then reload.
+- Skills are available as slash commands (e.g. `/neohive-launch-team`, `/neohive-status`).
+
+---
+
+### Antigravity
+
+```bash
+npx neohive init --antigravity
+```
+
+Installs MCP config globally (`~/.gemini/antigravity/mcp_config.json`) and skills into `.agent/skills/neohive/`. After init:
+
+- Open Antigravity Settings → MCP and **verify that `neohive` is enabled**. Like Cursor, Antigravity may disable new MCP servers by default.
+
+---
+
+### Everything at once
+
+```bash
+npx neohive init --all
+```
+
+Configures MCP, hooks, skills, agents, and commands for every detected CLI and IDE in one command.
+
+---
+
+### Troubleshooting
+
+**Agent can't register / MCP tools not found**
+The IDE has likely disabled the neohive MCP server. Restart the IDE first, then go to Settings → MCP (or Tools), find `neohive`, and enable it. After enabling, start a new agent thread — existing sessions won't pick up the newly registered tools.
+
+**Agent stopped listening mid-session**
+Due to a current IDE limitation, agents can occasionally drop out of the listen loop. Simply ask the agent: *"Call listen()"* to resume. We are actively working on a permanent fix.
+
+---
+
 ## 🏗 How It Works
 
 ```
@@ -225,8 +304,8 @@ The MCP server exposes **70+ built-in tools** in one registration list (no separ
 | Category | Tools |
 |----------|-------|
 | **Identity & briefing** | `register` · `list_agents` · `update_profile` · `get_briefing` · `get_guide` |
-| **Messaging** | `send_message` · `broadcast` · `listen` · `listen_group` · `listen_codex` · `wait_for_reply` · `check_messages` · `consume_messages` · `get_notifications` · `ack_message` |
-| **History & search** | `get_history` · `get_summary` · `search_messages` · `get_compressed_history` |
+| **Messaging** | `send_message` · `broadcast` · `listen` · `wait_for_reply` · `messages` |
+| **History & search** | `get_summary` · `get_compressed_history` · `messages` |
 | **Collaboration** | `handoff` · `share_file` · `lock_file` · `unlock_file` |
 | **Tasks** | `create_task` · `update_task` · `list_tasks` |
 | **Workflows** | `create_workflow` · `advance_workflow` · `workflow_status` |
@@ -256,10 +335,14 @@ neohive status              # active agents, tasks, workflows
 neohive msg <agent> <text>  # send message from CLI
 neohive doctor              # diagnostic health check
 neohive templates           # list available templates
+neohive hooks               # install listen-enforcement hooks into .claude/settings.json
+neohive skills              # install neohive skills & agents for all detected IDEs
 neohive reset --force       # clear data (auto-archives first)
 neohive uninstall           # remove from all CLI configs
 ```
 
+> `init` runs `hooks` and `skills` automatically. Run them standalone at any time to update or repair your setup.
+
 <br />
 
 ## ⚙️ Configuration
@@ -273,6 +356,26 @@ neohive uninstall           # remove from all CLI configs
 
 <br />
 
+## 🧩 VS Code Extension
+
+The [Neohive extension](https://marketplace.visualstudio.com/items?itemName=alionix.neohive) brings agent monitoring and team coordination directly into your editor.
+
+| Feature | Description |
+|---------|-------------|
+| **Agent Sidebar** | See all registered agents, their status (online/stale/offline), and provider in the activity bar |
+| **Task Board** | In-editor kanban board — view and track tasks without opening the dashboard |
+| **Workflow Viewer** | Monitor active workflows and step progress in real time |
+| **`@neohive` Chat** | Query agent status, tasks, and messages directly from Copilot Chat |
+| **Auto MCP Setup** | Configures MCP and hooks automatically on activation — no manual config needed |
+
+**Install:** [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=alionix.neohive) — or search "Neohive" in the Extensions panel.
+
+<br />
+
+<img src="https://raw.githubusercontent.com/fakiho/neohive/master/vscode-extension/assets/screenshots/vscode-extension-overview.png" alt="Neohive VS Code Extension — Team Chat, Agent Sidebar, Task Board, and Workflows" width="100%" />
+
+<br />
+
 ## 🔐 Security
 
 Neohive is a **local message broker**. It passes text between CLI terminals via shared files. It does not access the internet, store API keys, or run cloud services.
@@ -338,8 +441,9 @@ node dashboard.js # run the dashboard
 </p>
 
 <p align="center">
+  <a href="https://neohive.alionix.com">Website</a> &middot;
   <a href="https://github.com/fakiho/neohive">GitHub</a> &middot;
   <a href="https://www.npmjs.com/package/neohive">npm</a> &middot;
-  <a href="docs/documentation.md">Docs</a> &middot;
+  <a href="../docs/documentation.md">Docs</a> &middot;
   <a href="mailto:contact@alionix.com">Contact</a>
 </p>