{
  "markdown": "# Searchwave\n\nSearchwave is a context agent for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) that gets you (and Claude) up to speed on anything in about 60 seconds. \n\nThink native Claude Code search, but better and more comprehensive. Think Deep Research, but more concise, useful, and right in your terminal and Claude Code workflow.\n\n## How it works\n\nSearchwave works best when configured as a /command in Claude Code, to easily invoke the different modes.\n\n`/wave` runs 3 parallel web searches, selects the best sources, fetches their content, and synthesizes a cited summary. The whole process takes about 60 seconds with no configuration or follow-up questions.\n\n`/deepwave` adds depth control. Before running, it asks how deep (Quick / Standard / Max) and what angle matters most. All tiers use Opus for synthesis. Max mode dispatches 3 parallel research agents, evaluates source quality, and supports iterative follow-up.\n\nOutput is structured for terminals: inline citations, survey voice, hard-wrapped at 80 columns.\n\n### Use cases\n\n- Check how a framework or library works before adopting it\n- Compare tools or approaches with real data\n- Verify technical requirements or compatibility\n- Get up to speed on an unfamiliar topic mid-task\n- A general web search replacement\n- A skill for other agents to use when additional context is necessary outside of pre-trained data\n\n## Installation\n\n### Claude Code (via Plugin Marketplace)\n\nRegister the marketplace:\n\n```\n/plugin marketplace add rowbradley/searchwave-marketplace\n```\n\nInstall the plugin:\n\n```\n/plugin install searchwave@searchwave-marketplace\n```\n\nRestart Claude Code after installing. Commands will be available as `/searchwave:wave` and `/searchwave:deepwave`.\n\n### Shorter Command Names (Recommended)\n\nFor `/wave` and `/deepwave` without the namespace prefix, copy the command files locally:\n\n```bash\ngit clone https://github.com/rowbradley/searchwave.git\ncp searchwave/commands/wave.md ~/.claude/commands/\ncp searchwave/commands/deepwave.md ~/.claude/commands/\n```\n\nLocal commands take priority over plugin commands and give you the shorter names.\n\n### Verify Installation\n\n```\n/help\n```\n\nYou should see `/wave` and `/deepwave` in your available commands.\n\n### Manual Install\n\n```bash\ngit clone https://github.com/rowbradley/searchwave.git\ncp -r searchwave/skills/wave ~/.claude/skills/\ncp -r searchwave/skills/deepwave ~/.claude/skills/\n```\n\n## Commands\n\n| Command | Time | Use when |\n|---------|------|----------|\n| `/wave [topic]` | ~60s | Quick context — get up to speed fast |\n| `/deepwave [topic]` | 70s–10min | Deep evaluation — make a decision with real data |\n\nStart with `/wave`. If you need more depth, it'll be obvious.\n\n## /wave — Quick Context\n\n3 parallel searches → 3 best sources fetched → Sonnet synthesis. No questions asked. You type, it runs.\n\n**What you get:** 300–400 words, inline citations, survey voice. Hard-wrapped at 80 columns for terminal readability.\n\n## /deepwave — Deep Evaluation\n\nAsks two things before running: how deep, and what angle matters most.\n\n| Tier | Time | Architecture |\n|------|------|--------------|\n| Quick | ~70s | 3 searches, Opus synthesis |\n| Standard | ~90s | 6 searches, Opus synthesis |\n| Max | ~5–10min | 3 parallel research agents → Opus evaluation → follow-up loop |\n\n**What you get:** Survey-style report with inline citations, source quality notes, and confidence assessment. Max mode adds a \"Go Deeper?\" loop for iterative exploration.\n\n### How Max Mode Works\n\n```\n┌─────────────────────────────────────────┐\n│  /deepwave \"topic\" → Max mode           │\n├─────────────────────────────────────────┤\n│                                         │\n│  Wave 1: 3 parallel research agents     │\n│  ┌──────────┬──────────┬──────────┐     │\n│  │ Agent A  │ Agent B  │ Agent C  │     │\n│  │ Facts    │ How-to   │ Why      │     │\n│  │ (what)   │ (how)    │ (why)    │     │\n│  └────┬─────┴────┬─────┴────┬─────┘     │\n│       └──────────┼──────────┘           │\n│                  ▼                      │\n│  Opus Evaluation (quality signals)      │\n│       │                                 │\n│       ├─ SUFFICIENT → Synthesize        │\n│       └─ NEEDS_MORE → Wave 2 → Synth    │\n│                                         │\n│  Final: Opus synthesis with confidence  │\n│  assessment + \"Go Deeper?\" loop         │\n└─────────────────────────────────────────┘\n```\n\n## Design Principles\n\n- **Survey voice** — reports what was found, doesn't editorialize\n- **Inline citations** — every claim attributed to its source\n- **Source quality awareness** — vendor reports flagged, limitations noted\n- **No AI writing patterns** — no hyperbole, no reframes, numbers first\n- **Terminal-native** — hard-wrapped at 80 columns\n\n## Requirements\n\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) with WebSearch access\n- Works best with Sonnet 4 or Opus 4.5\n\n## Variants\n\n### Sonnet (Token-Efficient)\n\n[searchwave-sonnet](https://github.com/rowbradley/searchwave-sonnet) — Same search and fetch architecture, all synthesis uses Sonnet explicitly. Lower token cost.\n\n```\n/plugin install searchwave-sonnet@searchwave-marketplace\n```\n\n### X10 (Experimental)\n\n[searchwave-x10](https://github.com/rowbradley/searchwave-x10) — 10-search variant of Standard mode. Opus synthesis.\n\n```\n/plugin install searchwave-x10@searchwave-marketplace\n```\n\n## Bash Hardening for Skill Authors\n\nIf your skills run parallel Bash calls (via Claude Code's tool system), these rules prevent cascade failures where one failed call kills all siblings:\n\n### `|| true` on every grep/filter\n`grep` returns exit code 1 when zero matches, which cascades to kill sibling tool calls.\n```bash\n# Bad — exit 1 on no matches kills siblings\nps aux | grep -E 'node|next' | grep -v grep\n\n# Good — neutralizes exit code\nps aux | grep -E 'node|next' | grep -v grep || true\n```\n\n### Avoid zsh reserved variable names\nzsh treats `status`, `pipestatus`, `MATCH`, `match` as read-only. Assigning to them throws a hard error.\n```bash\n# Bad — zsh read-only variable\nstatus=$(git status --porcelain)\n\n# Good — prefixed name\ngstatus=$(git status --porcelain)\n```\n\n### Newlines over `&&` for echo+pipe chains\n`&&` makes each segment dependent on the previous. Use newlines so echo failures don't kill pipes.\n```bash\n# Bad — echo failure kills grep\necho \"===SECTION===\" && ps aux | grep pattern\n\n# Good — independent statements\necho \"===SECTION===\"\nps aux | grep pattern || true\n```\n\nThese patterns are documented in detail in Claude Code's [parallel tool protocol](https://docs.anthropic.com/en/docs/claude-code).\n\n## License\n\nMIT\n",
  "bytes": 6612,
  "sha": "2b29623648177ff3c87ff9420b6b61c7c74e05439813f015500350eee995e483",
  "repo_slug": "rowbradley/searchwave",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_rowbradley_searchwave_searchwave_26b694b1/readme"
}