semtools

Performs CLI semantic search across local files and code repositories.

2|1|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/masseater/claude-code-plugin --skill semtools
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: semtools
Source: https://github.com/masseater/claude-code-plugin/tree/main/plugins/mutils/skills/semtools
Command: npx skills add https://github.com/masseater/claude-code-plugin --skill semtools

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

semtools provides a CLI for semantic search over local docs and code, enabling you to find relevant items even when exact keywords aren’t present.

Core Features & Use Cases

  • search: Local semantic search across files and docs.
  • workspace: Cache management for large-scale searches.
  • parse: Convert PDFs/DOCX/PPTX to Markdown via LlamaParse (requires API key).

Quick Start

Install semtools, then run a search like: search "API design" docs/*.md

Frequently Asked Questions about semtools

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search code and documents semantically without exact keyword matches?

Semantic search finds relevant content by meaning rather than exact keywords. semtools performs semantic search over local files—PDFs, DOCX, PPTX, Markdown, and source code—using adjustable similarity thresholds to locate matches beyond word-for-word hits, ideal for discovering API patterns or design approaches buried in large codebases.

Can I search across multiple file formats in a single query?

Yes. semtools searches across PDFs, DOCX, PPTX, Markdown, and source files simultaneously using its search command. The parse command converts PDFs, DOCX, and PPTX to Markdown first via LlamaParse, enabling uniform semantic indexing across mixed document types in your repository.

How do I set up semantic search over a local repository or documentation?

Install semtools, configure your LlamaParse API key in ~/.semtools_config.json, then run search queries against local files. Use the workspace command to cache results for large-scale searches, and adjust --max-distance and --n-lines flags to control similarity thresholds and context window size.

What do I need before using semtools for document parsing?

You need a LlamaParse API key to convert PDFs, DOCX, and PPTX files. Store credentials in ~/.semtools_config.json. For search-only workflows over existing Markdown or source files, no API key is required—only local file access.

How does semantic search differ from keyword-based code search?

Keyword search requires exact term matches; semantic search understands meaning and context. semtools finds conceptually related code—like authentication patterns—even when terminology differs, using adjustable similarity thresholds to balance precision and recall across your codebase.

Can I control how much context is returned around search results?

Yes. The --n-lines flag in semtools adjusts how many surrounding lines appear in results. Use --max-distance to fine-tune the similarity threshold, allowing you to balance between strict matches and broader semantic hits across your documents.