Skip to content

GistdexSemantic Search & Indexing

CLI tool for indexing and searching content using vector databases

Quick Start

Use Gistdex without installation:

bash
# Using npx (recommended)
npx @ushironoko/gistdex --help

# Using pnpm dlx
pnpm dlx @ushironoko/gistdex --help

Claude Code Integration

Add Gistdex to Claude Code with one command:

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

Basic Usage

Initialize the database:

bash
npx @ushironoko/gistdex init

Index your first content:

bash
# Index a GitHub Gist
npx @ushironoko/gistdex index --gist https://gist.github.com/username/gist-id

# Index local files
npx @ushironoko/gistdex index --files "src/**/*.ts"

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

Why Gistdex?

Gistdex uses semantic search to find content based on meaning rather than exact keywords. It indexes your code snippets, documentation, and text files for natural language queries.

Key Points

  • Preserve Boundaries with tree-sitter: Automatic chunk optimization using tree-sitter CST
  • Local Storage: Data stays on your machine using SQLite
  • MCP Server: Works with Claude through Model Context Protocol
  • CLI Tool: Command-line interface

Released under the MIT License.