Add non-interactive mode to claude-search CLI

[MaxGhenis]

Summary

• Adds --no-interactive / -n flag to claude-search that prints results and exits without the V/E/Q interactive prompt
• Adds --help / -h with proper usage info (via argparse)
• Adds --max-results / -m flag (was hardcoded to 20)
• Replaces manual sys.argv parsing with argparse
• Preserves existing interactive behavior when no flags are given

Motivation

claude-search currently hangs in non-interactive contexts because input() blocks waiting for stdin:

• Claude Code sessions — running claude-search from within Claude Code's Bash tool hangs on the V/E/Q prompt
• Piped/scripted contexts — e.g. claude-search "query" | head
• CI/automation workflows

Closes #44

Test plan

• 15 new tests in tests/test_search_cli.py covering:
  • Argument parsing (parse_args)
  • --no-interactive skips input() calls
  • --no-interactive still prints results
  • --max-results forwarded to searcher
  • --help prints usage and exits
  • Interactive mode preserved without flags
• All 15 tests passing
• flake8 clean (no new lint issues)
• Existing tests unaffected

Usage

# Non-interactive (safe for scripts/Claude Code):
claude-search -n "Rules Foundation"
claude-search --no-interactive --max-results 5 "query"

# Interactive (existing behavior, unchanged):
claude-search "query"

🤖 Generated with Claude Code