Skip to content

PROMOTION.md

Latest commit

 

History

History
287 lines (223 loc) · 9.06 KB

PROMOTION.md

File metadata and controls

287 lines (223 loc) · 9.06 KB

CodeSeeker Promotion Strategy

A comprehensive guide to promoting CodeSeeker as an open source MCP plugin.

Target Audience

  • Primary: Developers using Claude Code (CLI or VS Code extension) who want semantic code search
  • Secondary: Developers using other AI assistants (GitHub Copilot, Cursor) via MCP
  • Tertiary: Teams looking for intelligent codebase understanding tools

Key Value Propositions

  1. MCP Plugin for Claude Code - One command install: /plugin install codeseeker@github:jghiringhelli/codeseeker#plugin
  2. Semantic Code Search - Find code by meaning, not just text patterns
  3. Hybrid Search - Vector similarity + Full-text (BM25) + Path matching with RRF fusion
  4. Multi-IDE Support - Works with Claude Code, GitHub Copilot, Cursor, Visual Studio
  5. Auto-Detected Coding Standards - Learns and applies your project's patterns
  6. Fast Incremental Sync - Two-stage change detection (mtime + hash) for near-instant updates

Promotion Channels

1. GitHub Optimization

Repository Setup

  • Add descriptive topics/tags:
    • claude, claude-code, ai, cli, code-assistant
    • developer-tools, semantic-search, typescript, nodejs
    • anthropic, llm, code-analysis

README Enhancements

  • Add GIF/video demo showing the 11-step core cycle
  • Clear "Quick Start" section (3-5 commands)
  • Comparison table: CodeSeeker vs raw Claude Code
  • Architecture diagram showing hybrid search flow

Badges to Add

![npm version](https://img.shields.io/npm/v/codeseeker)
![License](https://img.shields.io/github/license/jghiringhelli/codeseeker)
![Build Status](https://img.shields.io/github/actions/workflow/status/jghiringhelli/codeseeker/ci.yml)
![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)

2. Developer Communities

Hacker News

  • Post as "Show HN: CodeSeeker - Semantic context enhancement for Claude Code"
  • Best posting time: Tuesday-Thursday, 9-11 AM EST
  • Prepare for questions about:
    • How it differs from MCP servers (like Serena)
    • Performance overhead
    • Privacy/security of code analysis

Reddit

  • r/programming - Technical deep dive post
  • r/typescript - TypeScript implementation details
  • r/ClaudeAI - Direct audience match
  • r/ChatGPT - Broader AI tools audience
  • r/devops - CI/CD integration potential

Dev.to / Hashnode Articles

  • "How I Enhanced Claude Code with Semantic Search"
  • "Building a Hybrid Search System for Code: Vector + FTS + Path Matching"
  • "Task Decomposition: Breaking Complex Queries for Better AI Responses"

Discord Communities

  • Anthropic Discord (official)
  • TypeScript Discord
  • Node.js Discord

3. Social Media

X/Twitter Strategy

  • Create a thread explaining the core cycle
  • Use hashtags: #ClaudeAI #DevTools #TypeScript #OpenSource
  • Tag @AnthropicAI for visibility
  • Share code snippets showing before/after

LinkedIn

  • Post for professional developer audience
  • Focus on productivity gains and enterprise use cases

4. npm Registry

Package Optimization

{
  "keywords": [
    "claude", "claude-code", "ai", "cli", "semantic-search",
    "code-assistant", "developer-tools", "typescript", "anthropic",
    "llm", "code-analysis", "context-enhancement"
  ]
}

5. Content Creation

YouTube Video Ideas

  1. "5-Minute Demo: CodeSeeker MCP Plugin for Claude Code" (intro)
  2. "Deep Dive: Hybrid Search Architecture" (technical)
  3. "Setting Up CodeSeeker with Multiple IDEs" (tutorial)
  4. "CodeSeeker vs grep: Finding Code by Meaning" (comparison)

Blog Post Series

  1. Introduction and Quick Start (plugin install)
  2. Semantic Search: Why "Find auth logic" beats grep
  3. Hybrid Search: Vector + FTS + Path with RRF Fusion
  4. Auto-Detected Coding Standards: How CodeSeeker Learns Your Patterns
  5. Multi-IDE Setup: Claude Code, Copilot, Cursor

6. Documentation Site

Consider GitHub Pages or similar:

  • Landing page with value proposition
  • Installation guide
  • Configuration options
  • Use case examples
  • API reference
  • Contributing guide

Launch Checklist

Pre-Launch

  • README is polished with demo GIF
  • All badges are working
  • CHANGELOG is up to date
  • LICENSE file is present
  • CONTRIBUTING.md is complete
  • SECURITY.md is in place
  • npm package metadata is optimized

Launch Day

  • Push final release to GitHub
  • Publish to npm registry
  • Post to Hacker News (Show HN)
  • Post to r/programming
  • Tweet announcement thread
  • Post on LinkedIn

Post-Launch

  • Monitor GitHub issues
  • Respond to HN/Reddit comments
  • Collect user feedback
  • Write follow-up content based on questions

Conference Presentation Guide

Slide Outline (20-30 minutes)

1. Opening (2 min)

  • The problem: AI assistants don't understand your codebase
  • grep/glob find text, not meaning

2. The Solution: CodeSeeker (3 min)

  • MCP plugin for semantic code search
  • One-command install: /plugin install codeseeker@github:jghiringhelli/codeseeker#plugin
  • Works with Claude Code, Copilot, Cursor

3. Live Demo: Search Comparison (5 min)

  • Show grep: grep -r "authentication" - finds literal text
  • Show CodeSeeker: search("user login flow") - finds auth, session, credentials
  • Key message: "Find code by WHAT it does, not just WHAT it says"

4. How It Works: Hybrid Search (5 min)

  • Vector embeddings (semantic similarity)
  • Full-text search (BM25 with synonyms)
  • Path matching (file/folder names)
  • RRF fusion for optimal ranking
  • Diagram: Show the three parallel searches merging

5. Live Demo: Real-World Usage (5 min)

  • find_and_read("validation logic") - search + read in one call
  • get_code_relationships - show imports/dependencies
  • get_coding_standards - show auto-detected patterns

6. Performance Optimizations (3 min)

  • Lazy loading: MCP server starts in ~50ms
  • Two-stage change detection: mtime (~0.1ms) then hash (~1-5ms)
  • SQLite embedded mode: Zero setup, instant start

7. Multi-IDE Support (2 min)

  • Claude Code: Built-in plugin
  • GitHub Copilot: .vscode/mcp.json
  • Cursor: .cursor/mcp.json
  • Same MCP server, different configs

8. Q&A / Call to Action (5 min)

  • GitHub: github.com/jghiringhelli/codeseeker
  • Try it: /plugin install codeseeker@github:jghiringhelli/codeseeker#plugin

Demo Script

Setup (before presentation)

  1. Have a real project indexed (not toy example)
  2. Prepare 3-4 search queries that show semantic understanding
  3. Test all demos work offline if venue has unreliable WiFi

Demo 1: grep vs semantic search

# Traditional: grep finds "auth" literally
grep -r "auth" src/

# CodeSeeker: finds authentication even if code says "login", "session", "credentials"
search("user authentication flow")

Demo 2: find_and_read

# One call: search + read file with line numbers
find_and_read("error handling for API calls")

Demo 3: Code relationships

# Show what imports/calls a file
get_code_relationships({filepath: "src/auth/login.ts"})

Demo 4: Coding standards

# Show auto-detected patterns
get_coding_standards({project: "my-app", category: "validation"})

Conference Targets

Conference Audience Focus
Local meetups General devs Quick intro + demo
AI/ML conferences Technical Hybrid search architecture
DevTools conferences Tool builders MCP integration, plugin system
Language-specific (JS/TS, Python) Language users Practical usage

Materials to Prepare

  • Slides (Google Slides or reveal.js for code formatting)
  • Demo project with interesting codebase
  • Backup video recording of demos (in case of issues)
  • QR code linking to GitHub repo
  • Business cards or handout with install command

Messaging Templates

One-Liner

CodeSeeker: Semantic code search plugin for Claude Code and other AI assistants

Elevator Pitch

CodeSeeker is an MCP plugin that gives AI assistants semantic understanding of your codebase. Instead of grep-style text matching, CodeSeeker finds code by meaning - ask for "authentication logic" and it finds files about login, sessions, and credentials. Install in one command, works with Claude Code, GitHub Copilot, and Cursor.

Technical Description

CodeSeeker provides semantic code search via MCP (Model Context Protocol):

  • Hybrid search: Vector embeddings + BM25 full-text + path matching with RRF fusion
  • Embedded mode: SQLite + MiniSearch - zero setup, instant start
  • Two-stage change detection: mtime (~0.1ms) then hash (~1-5ms) for fast sync
  • Auto-detected coding standards from your codebase
  • Multi-IDE: Same MCP server works with any MCP-compatible AI assistant

Metrics to Track

  • GitHub stars and forks
  • npm weekly downloads
  • GitHub issues and PRs
  • Social media engagement
  • Community mentions
  • User feedback themes

Timeline

Week Activities
1 GitHub polish, npm publish, initial posts
2 Blog posts, video content creation
3 Community engagement, respond to feedback
4 Feature updates based on feedback
5+ Ongoing content and community building