Semantiqv0.5.2
01Home
02Features
03Docs
04Blog
05Changelog
06Support
Get Started

Getting Started

  • Quick StartGet started in 5 minutes

Reference

  • CLI CommandsCommand reference
  • MCP IntegrationAI assistant setup
  • Usage GuideUsage patterns
  • Optimal WorkflowDevelopment workflow
  • Semantiq vs grepvs grep & find
  • ChangelogVersion history

Loading documentation...

Semantiq

One MCP Server for every AI coding tool. Powered by Rust and Tree-sitter.

GitHub

Product

  • Features
  • Documentation
  • Changelog

Resources

  • Quick Start
  • CLI Reference
  • MCP Integration
  • Blog

Connect

  • Support
  • GitHub
// 19 languages supported
Rust
TypeScript
JavaScript
Python
Go
Java
C
C++
PHP
Ruby
C#
Kotlin
Scala
Bash
Elixir
HTML
JSON
YAML
TOML
© 2026 Semantiq.|v0.5.2|connected
MIT·Built with Rust & Tree-sitter
  1. Home
  2. Docs
  3. CLI Reference
Reference
4 min read

CLI Reference

Complete reference for all Semantiq CLI commands.

CLI Reference#

Complete reference for all Semantiq CLI commands.

semantiq init#

Initialize Semantiq for Claude Code. Creates index and configures MCP settings automatically.

Plain Text
1semantiq init [PATH] [OPTIONS]
2
3Arguments:
4 [PATH] Directory to initialize (default: current directory)
5
6Options:
7 -v, --verbose Show detailed output
8 -h, --help Print help

Examples#

Terminal
1# Initialize in current directory
2semantiq init
3
4# Initialize a specific project
5semantiq init /path/to/project
6
7# Initialize with verbose output
8semantiq init . --verbose

semantiq init-cursor#

Initialize Semantiq for Cursor/VS Code. Creates index and generates .cursor/mcp.json configuration.

Plain Text
1semantiq init-cursor [PATH] [OPTIONS]
2
3Arguments:
4 [PATH] Directory to initialize (default: current directory)
5
6Options:
7 -v, --verbose Show detailed output
8 -h, --help Print help

Examples#

Terminal
1# Initialize for Cursor in current directory
2semantiq init-cursor
3
4# Initialize a specific project for Cursor
5semantiq init-cursor /path/to/project

semantiq stats#

Display statistics about the current index (files, symbols, size, etc.).

Plain Text
1semantiq stats [OPTIONS]
2
3Options:
4 --json Output results as JSON
5 -h, --help Print help

Examples#

Terminal
1# Show index statistics
2semantiq stats
3
4# Output as JSON
5semantiq stats --json

semantiq index#

Index a directory to create or update the semantic database.

Plain Text
1semantiq index [PATH] [OPTIONS]
2
3Arguments:
4 [PATH] Directory to index (default: current directory)
5
6Options:
7 -v, --verbose Show detailed output
8 -f, --force Force re-index all files
9 --exclude Patterns to exclude (can be repeated)
10 -h, --help Print help

Examples#

Terminal
1# Index current directory
2semantiq index
3
4# Index with verbose output
5semantiq index . --verbose
6
7# Force re-index everything
8semantiq index --force
9
10# Exclude specific directories
11semantiq index --exclude node_modules --exclude dist

semantiq search#

Search for code patterns, symbols, or text in the indexed codebase.

Plain Text
1semantiq search <QUERY> [OPTIONS]
2
3Arguments:
4 <QUERY> Search query (supports natural language)
5
6Options:
7 -l, --limit Maximum number of results (default: 20)
8 --min-score Minimum similarity score 0.0-1.0 (default: 0.35)
9 --file-type Filter by file type (e.g., ts, py, rs)
10 --symbol-kind Filter by symbol kind (function, class, etc.)
11 --json Output results as JSON
12 -h, --help Print help

Examples#

Terminal
1# Search for a pattern
2semantiq search "authentication"
3
4# Search with limit and min score
5semantiq search "handler" --limit 5 --min-score 0.5
6
7# Filter by file type
8semantiq search "config" --file-type ts
9
10# Filter by symbol kind
11semantiq search "User" --symbol-kind class
12
13# Output as JSON
14semantiq search "database" --json

semantiq find-refs#

Find all references to a symbol including definitions and usages.

Plain Text
1semantiq find-refs <SYMBOL> [OPTIONS]
2
3Arguments:
4 <SYMBOL> Symbol name to find references for
5
6Options:
7 -l, --limit Maximum number of results (default: 50)
8 --json Output results as JSON
9 -h, --help Print help

Examples#

Terminal
1# Find all references to a function
2semantiq find-refs handleRequest
3
4# Find references to a class
5semantiq find-refs UserService
6
7# Output as JSON
8semantiq find-refs Config --json

semantiq deps#

Analyze the dependency graph for a file.

Plain Text
1semantiq deps <FILE> [OPTIONS]
2
3Arguments:
4 <FILE> File path to analyze
5
6Options:
7 --imports Show only imports (what this file depends on)
8 --dependents Show only dependents (what depends on this file)
9 --depth Maximum depth for transitive dependencies
10 --json Output results as JSON
11 -h, --help Print help

Examples#

Terminal
1# Analyze a file's dependencies
2semantiq deps src/auth/handler.ts
3
4# Show only imports
5semantiq deps src/index.ts --imports
6
7# Show only dependents
8semantiq deps src/utils.ts --dependents

semantiq explain#

Get detailed explanation of a symbol including definition, docs, and usage patterns.

Plain Text
1semantiq explain <SYMBOL> [OPTIONS]
2
3Arguments:
4 <SYMBOL> Symbol name to explain
5
6Options:
7 --json Output results as JSON
8 -h, --help Print help

Examples#

Terminal
1# Explain a function
2semantiq explain handleAuth
3
4# Explain a class
5semantiq explain DatabaseConnection

semantiq serve#

Start Semantiq as an MCP server for integration with AI assistants.

Plain Text
1semantiq serve [OPTIONS]
2
3Options:
4 --stdio Use stdio for MCP communication (default)
5 --port Use HTTP transport on specified port
6 -h, --help Print help

Examples#

Terminal
1# Start MCP server (stdio)
2semantiq serve
3
4# Start with HTTP transport
5semantiq serve --port 8080

See Also#

  • Usage Guide - Practical examples for each tool
  • MCP Integration - Configure with AI assistants

Was this page helpful? Let us know on GitHub.