# vexor-cli

Скилл учит агента искать файлы по смыслу запроса, а не по точному тексту. Пригодится в среднем или крупном репозитории, где непонятно, где что лежит.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 247
- Автор: scarletkc
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/scarletkc/vexor/tree/HEAD/plugins/vexor/skills/vexor-cli/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/vexor-cli

## Что делает

Скилл оборачивает утилиту `vexor` и подсказывает агенту вызывать её первой, когда нужно найти, где что-то реализовано или определено. Внутри — описание команды `vexor "<QUERY>"` с флагами: `--path`, `--mode`, `--ext`, `--exclude-pattern`, `--top`, `--content`, `--format`. Режимы разной цены: `name` смотрит только имена файлов, `code` режет `.py/.js/.ts` с учётом кода, `outline` разбирает заголовки Markdown, `full` индексирует содержимое целиком.

Полезная деталь — `--content`: совпавший исходник печатается сразу под таблицей, и отдельно открывать файлы уже не нужно. Текст лежит между `content_start_line` и `content_end_line`, а это может быть позже `start_line`, если длинный символ попал в индекс несколькими кусками. Увидели `stale_line_range` — файл менялся после индексации, помогает повторный `vexor index`.

Настройки берутся из ближайшего `.vexor/config.json`; принимаются только `rerank`, `auto_index`, `model`, `embedding_dimensions`, `batch_size`, `embed_concurrency` и `extract_concurrency`. Ключи и адреса (`api_key`, `base_url`, `remote_rerank`) в проектном конфиге отклоняются. Правила из `.vexorignore` действуют всегда, даже с `--no-respect-gitignore`. Если `vexor` не установлен, скилл отправляет к `references/install-vexor.md`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scarletkc/vexor --skill vexor-cli -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/vexor-cli/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/vexor-cli/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scarletkc/vexor --skill vexor-cli -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/vexor-cli/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scarletkc/vexor --skill vexor-cli -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/vexor-cli/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install scarletkc/vexor vexor-cli
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/vexor-cli/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scarletkc/vexor --skill vexor-cli -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/scarletkc/vexor --path plugins/vexor/skills/vexor-cli
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/vexor-cli/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add scarletkc/vexor --skill vexor-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/scarletkc/vexor/tree/HEAD/plugins/vexor/skills/vexor-cli/SKILL.md

## Когда брать
- найти, где в репозитории загружается и валидируется конфиг
- откопать точку входа CLI по описанию, а не по имени файла
- пройтись по документации и вытащить раздел про авторизацию
- исключить тесты и JS-файлы из выдачи одним запросом
- получить исходник совпадения сразу, без чтения файла следом

## Примеры запросов агенту
- Найди через vexor, где валидируются JWT-claims, режим `code`, с содержимым
- Поищи в docs раздел про поток аутентификации: `vexor search "user authentication flow" --path docs --mode outline --ext .md`
- Где загружается конфиг? Ищи по коду, исключи `tests/**` и `.js`

## Похожие
- [ccc](https://affpapa.org/nevibecode/skills/ccc.md) — скилл · 5900 установок
- [jevgrep](https://affpapa.org/nevibecode/skills/jevgrep.md) — скилл · 1300 установок
- [cli-anything-chromadb](https://affpapa.org/nevibecode/skills/cli-anything-chromadb.md) — скилл · 505 установок
- [grepai-mcp-claude](https://affpapa.org/nevibecode/skills/grepai-mcp-claude.md) — скилл · 612 установок
- [socraticode](https://affpapa.org/nevibecode/plugins/socraticode.md) — плагин · ★ 3355
- [codealive-mcp](https://affpapa.org/nevibecode/mcp/codealive-mcp.md) — MCP-сервер · ★ 90

Из того же набора: [scarletkc/vexor](https://affpapa.org/nevibecode/by/scarletkc/vexor.md) — 2 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md