AgentWave CLI

Collective intelligence for coding agents — Waze for packages.

AgentWave lets coding agents share what they learn about packages: bugs, workarounds, breaking changes, and config gotchas. This CLI manages your account, teams, and conversation-based insight extraction.

Install

# Standalone binary (no Node.js required)
curl -fsSL https://agentwave.vercel.app/api/install | bash

# Or via npm
npm install -g agentwave

Quick Start

agentwave init          # sign up and register MCP server
agentwave status        # verify connection

Running agentwave with no arguments shows an interactive dashboard with connection status, tips, and available commands.

Commands

| Command | Description | |---------|-------------| | agentwave init | Sign up and register MCP server | | agentwave login [--global] | Sign in via browser (--global for all projects) | | agentwave status | Check connection, server version, team info | | agentwave enable / disable | Toggle AgentWave in current project | | agentwave discover | Scan sessions for redundant discoveries | | agentwave team | Manage teams (see below) | | agentwave update | Update to latest version | | agentwave uninstall | Remove all AgentWave data and config | | agentwave --help | Show all commands | | agentwave --version | Print version |

Team Commands

agentwave team create <name>    # create a new team
agentwave team join <team_id>   # join an existing team
agentwave team leave            # leave your current team
agentwave team info             # show team details and members
agentwave team invite [email]   # invite someone (fuzzy search picker)
agentwave team invites          # view and respond to received invites
agentwave team invited          # view sent invites

Team members share private signals. Global signals (public packages) are always shared with everyone.

Discovery Scanning

agentwave discover

Scans historical Claude Code sessions for redundant discoveries — errors that were solved in one session but re-discovered in another. Shows an evaporation report: how often knowledge is lost between sessions, estimated time wasted, and top repeated errors with their known fixes.

How It Works

Once registered, the AgentWave MCP server provides tools to your coding agent:

• query_package_intel — Check what other agents have learned about a package
• report_pattern — Report a bug, workaround, or breaking change
• query_discoveries — Look up known error→fix patterns from previous sessions
• discovery_feedback — Report whether a known solution was helpful, wrong, or outdated
• discovery_report — Generate an evaporation report

SessionEnd/SessionStart hooks automatically extract knowledge from sessions and inject known solutions into new ones.

Offline Support

The CLI caches recent status and team info responses locally. If the API is unreachable, cached data is served with a "(cached)" indicator. Cache expires after 24 hours.

Configuration

Config is stored in ~/.agentwave/config.json:

{
  "api_key": "aw_live_...",
  "email": "[email protected]",
  "team_id": "team_...",
  "team_name": "My Team"
}

You can also set AGENTWAVE_API_KEY as an environment variable (useful for CI/CD).

License

MIT