Quick Setup
Quick setup:
For Claude Code (automatic MCP configuration):
Terminal
npx semantiq-mcp initFor Cursor / VS Code (generates mcp.json):
Terminal
npx semantiq-mcp init-cursorInstallation
Install Semantiq using npm (recommended):
Terminal
npm install -g semantiq-mcpOr install from source using Cargo:
Terminal
cargo install --git https://github.com/so-keyldzn/semantiq.gitIndexing Your Codebase
Navigate to your project directory and run the index command:
Terminal
1# Index the current directory2semantiq index .34# Index a specific directory5semantiq index /path/to/project67# Index with verbose output8semantiq index . --verboseSemantiq will create a .semantiq.db file in your project root. This file contains the semantic index of your codebase.
Searching Your Code
Use the search command to find code semantically:
Terminal
1# Search for a pattern2semantiq search "authentication handler"34# Search for a specific function5semantiq search "handleLogin"67# Search with limit and min score8semantiq search "database" --limit 10 --min-score 0.5MCP Server Mode
Start Semantiq as an MCP server to integrate with AI assistants like Claude Code:
Terminal
semantiq serveSee the MCP Integration guide for detailed configuration instructions.
Configuration
Semantiq can be configured using a .semantiq.toml file in your project root:
TOML
1# .semantiq.toml2[index]3# Patterns to exclude from indexing4exclude = [5 "node_modules",6 "target",7 ".git",8 "dist",9 "build"10]1112# Maximum file size to index (in bytes)13max_file_size = 1048576 # 1MB1415[languages]16# Enable/disable specific languages17rust = true18typescript = true19javascript = true20python = true21go = true22java = true23c = true24cpp = true25php = true26ruby = true27csharp = true28kotlin = true29scala = trueNext Steps
- CLI Reference - Complete command documentation
- MCP Integration - Configure with Claude Code