Semantic search CLI tool for indexing and searching content using vector databases.

Full documentation: https://gistdex.vercel.app/

# Use without installation
npx @ushironoko/gistdex --help

# Initialize configuration
npx @ushironoko/gistdex init

# Index content
npx @ushironoko/gistdex index --gist https://gist.github.com/username/gist-id
npx @ushironoko/gistdex index --files "src/**/*.ts"

# Search
npx @ushironoko/gistdex query "how to implement authentication"

Add to Claude Code with one command:

claude mcp add gistdex -- npx @ushironoko/gistdex --mcp

• Node.js >= 24.6.0 or Bun >= 1.1.14
• Google AI API key for embeddings (Get one here)

• Semantic Search - Search by meaning using Google's gemini-embedding-001
• Multi-Source Indexing - GitHub Gists, repositories, local files, plain text
• Local Storage - SQLite with sqlite-vec extension
• MCP Support - Claude integration via Model Context Protocol
• TypeScript Config - Type-safe configuration with intellisense
• Auto Chunk Optimization - File type-based chunk sizing

We welcome contributions! Please see our Contributing Guide for details.

# Clone the repository
git clone https://github.com/ushironoko/gistdex.git
cd gistdex

# Install dependencies
pnpm install

# Run tests
pnpm test

# Build
pnpm build

• pnpm test - Run tests
• pnpm run lint - Run linter
• pnpm run format - Format code
• pnpm run tsc - Type check
• pnpm run dev - Development mode
• pnpm run build - Build for production

MIT © ushironoko

• Documentation
• npm Package
• GitHub Repository
• Issue Tracker
• Changelog