Skip to content

GistdexSemantic Search & Indexing

CLI tool for indexing and searching contents. MCP and CI Itnegrations Feature

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 Features ​

  • Semantic Boundaries: Preserves code and document structure when chunking
  • Local-First: All data stays on your machine using SQLite or DuckDB with vector extensions
  • MCP Server: Direct integration with Claude for AI-assisted search
  • CLI and Library: Use as a command-line tool or integrate as a TypeScript library

Released under the MIT License.