# Carrel Search

Query the user's local knowledge bases through the Carrel search API, use original text...

- Repository: https://github.com/FengZhenfei/carrel (679 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add FengZhenfei/carrel --skill carrel-search -g -a claude-code -y`
Codex: `npx skills add FengZhenfei/carrel --skill carrel-search -g -a codex -y`
Cursor: `npx skills add FengZhenfei/carrel --skill carrel-search -g -a cursor -y`
Gemini CLI: `npx skills add FengZhenfei/carrel --skill carrel-search -g -a gemini-cli -y`

## Description

Query the user's local knowledge bases through the Carrel search API, use original text and source images as needed in the answer, list the reference files and offer follow-up directions drawn from the knowledge graph. Use when the user asks to search the knowledge base, find evidence in the stored material, compare records, or answer from several documents together.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Carrel-Search

Evidence is retrieved through Carrel's search service (`app/kb_search`, default port 9810); the agent invoking this skill understands the question, composes the answer, lists the reference files and turns the graph leads into directions the user can ask about next. The service only recalls, reranks and arranges evidence and does no generation. The display name is **Carrel-Search** and the invocation name is `$carrel-search`.

## Invocation

The client is `scripts/carrel_search.py` in this directory (Python 3.9+, standard library only). It defaults to `http://127.0.0.1:9810`; when the service runs on another machine, set the address and token through environment variables or a config file as described in [API and configuration](references/api.md). The skill contains no real token; never read or print one. `SKILL_DIR` stands for the directory containing this `SKILL.md`; replace it with the actual absolute path when executing.

```bash
python3 "$SKILL_DIR/scripts/carrel_search.py" search --question "<the user's question>"
```

The rest: https://github.com/FengZhenfei/carrel/blob/HEAD/skills/carrel-search/SKILL.md