# Sirchmunk

> Local file search using sirchmunk API. Use when you need to search for files or content by asking natural language questions.

- Skill: `modelscope/sirchmunk` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add modelscope/sirchmunk`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modelscope/sirchmunk/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: modelscope (https://skillmd.com/u/modelscope)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/modelscope/sirchmunk

---


# Sirchmunk Search

Simple local file search powered by LLM, no embedding-db, no indexing, no ETL.

## Tool: sirchmunk_search

**Single parameter:** `query` — your search question in natural language.

**Example:**
```bash
~/.openclaw/skills/sirchmunk/scripts/sirchmunk_search.sh "What is the RL agent's reward function?"
```

**Under the hood:**
```bash
curl -s -X POST "http://localhost:8584/api/v1/search" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "<your query>",
    "paths": ["/path/to/search_paths"],
    "mode": "DEEP",
    "response_format": "rich"
  }'
```

Notes: The `paths` parameter requires pre-configuration as `SIRCHMUNK_SEARCH_PATHS` or inclusion as a search parameter.


## Prerequisites

1. Sirchmunk installed: `pip install sirchmunk`
2. Run `sirchmunk init`
3. Config: `~/.sirchmunk/.env`, `LLM_API_KEY`、`LLM_BASE_URL` and `LLM_MODEL_NAME` are required. `SIRCHMUNK_SEARCH_PATHS` is optional.
4. Server running: `sirchmunk serve`


## Homepage
https://github.com/modelscope/sirchmunk