tailtest — плагин для Claude Code: автотесты после каждой правки
Плагин на хуках: как только Claude записывает файл, tailtest ставит его в очередь, генерирует сценарии и прогоняет их вашим тест-раннером. Провал возвращается в тот же ход.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install tailtest@claude-communityЧто делает tailtest
tailtest работает внутри цикла сборки. Claude правит файл, плагин перехватывает это событие и запускает генерацию сценариев по слою правил R1-R15. Сценарии описывают поведение бизнес-логики, а не сигнатуры функций. Дальше они уходят в ваш существующий раннер: pytest, vitest, jest, go test и другие.
Раннер определяется автоматически по манифестам вроде pyproject.toml, package.json, go.mod, build.gradle.kts, *.csproj и *.sln. Языки: Python, TypeScript, JavaScript, Go, Ruby, PHP, Java, Kotlin, C#, Rust. При успехе вы видите строку вида «tailtest: N scenarios — all passed», при падении — одну строку с ошибкой и вопрос, чинить ли.
Глубину задаёт .tailtest/config.json в корне проекта: simple даёт 2-3 сценария, standard — 5-8 и стоит по умолчанию, thorough — 10-15. Есть режим R15, который смещает генерацию в сторону восьми категорий поломок — на нём автор нашёл 16 реальных багов в 47 открытых Python-репозиториях. Лицензия MIT, телеметрии и аккаунта в SaaS нет. После установки Claude нужно перезапустить.
Какие задачи решает
- прогнать тесты сразу после того, как агент переписал файл
- поймать регрессию, пока правка ещё в контексте
- получить сценарии по бизнес-поведению, а не по сигнатурам
- подключить автотесты к уже настроенному раннеру без переписывания конфигов
- найти поломки в краевых случаях через режим R15
Примеры запросов агенту
- Проверь, что tailtest подхватил мой
pyproject.toml, и прогони сценарии по последней правке - Поставь в
.tailtest/config.jsonглубинуthoroughи перезапусти проверку - Включи режим R15 и покажи, какие категории поломок он нашёл в этом модуле
Как установить tailtest
Через маркетплейс плагинов
/plugin marketplace add anthropics/claude-plugins-community/plugin install tailtest@claude-communityПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о tailtest
Как установить tailtest в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add anthropics/claude-plugins-community, затем поставьте плагин: /plugin install tailtest@claude-community. После этого перезапустите Claude.
Что делает tailtest?
Следит за файлами, которые записал Claude, генерирует сценарии по слою правил R1-R15 и прогоняет их вашим тест-раннером. Результат возвращается агенту в том же ходе.
Какие языки и раннеры поддерживаются?
Python, TypeScript, JavaScript, Go, Ruby, PHP, Java, Kotlin, C#, Rust. Раннер определяется по стандартным манифестам проекта, отдельно его прописывать не нужно.
Исходный текст
SKILL.md · MIT
# tailtest -- AI software testing for Claude Code
[](https://opensource.org/licenses/MIT)
[](https://github.com/avansaber/tailtest)
[](https://github.com/avansaber/tailtest/releases/latest)
[](https://tailtest.com/platform/agent-edits/)
> You build. Claude builds. tailtest makes sure it works.
**tailtest** is the open-source AI software testing layer for [Claude Code](https://www.anthropic.com/claude-code). It runs inside the build loop: every time Claude edits a file, tailtest queues the file, generates production-shaped scenarios using the R1-R15 rule layer, runs them with your existing test runner (pytest, jest, go test, etc.), and surfaces failures back to Claude within the same turn. Hook-based. Deterministic. No prompting required.
Open source (MIT), no telemetry, no SaaS account. Includes adversarial mode (R15) that biases scenario generation toward 8 breakage categories -- the mode we've used to find 16 real bugs across 47 open-source Python repositories.
**[Read more on tailtest.com](https://www.tailtest.com/) · [Platform overview](https://www.tailtest.com/platform/) · [Agent-edit testing deep dive](https://www.tailtest.com/platform/agent-edits/) · [Full docs](https://www.tailtest.com/docs/)**
---
## Install
```bash
claude plugin marketplace add avansaber/tailtest
claude plugin install tailtest@avansaber-tailtest
```
Restart Claude Code after install. No other setup required.
## Update
```bash
claude plugin marketplace update avansaber-tailtest
claude plugin update tailtest@avansaber-tailtest
```
## Uninstall
```bash
claude plugin remove tailtest@avansaber-tailtest
```
---
## How it works
After any Claude-written file lands in your project:
1. tailtest generates scenarios that describe real business behavior -- not function signatures
2. It runs them using your existing test runner (pytest, vitest, jest, go test, and more)
3. Pass: `tailtest: N scenarios -- all passed.` Fail: one line surfaced, "want me to fix this?"
---
## Supported languages
Python, TypeScript, JavaScript, Go, Ruby, PHP, Java, Kotlin, C#, Rust
Runners are auto-detected from `pyproject.toml`, `package.json`, `go.mod`, `build.gradle.kts`, `*.csproj`, `*.sln`, and other standard manifests.
---
## Quick config
Create `.tailtest/config.json` in your project root to control depth:
```json
{ "depth": "standard" }
```
Options: `simple` (2-3 scenarios), `standard` (5-8, default), `thorough` (10-15).
See [tailtest.com/docs/config](https://tailtest.com/docs/config) for all options.
---
## Other tailtest variants
Same R1-R15 rule layer, same adversarial test mode, different host integration. **This repo is the Claude Code variant.**
- **[tailtest](https://github.com/avansaber/tailtest)** -- Claude Code plugin (hook-driven; this repo)
- **[tailtest-cursor](https://github.com/avansaber/tailtest-cursor)** -- Cursor plugin (hook-driven)
- **[tailtest-codex](https://github.com/avansaber/tailtest-codex)** -- Codex CLI plugin (hook-driven)
- **[tailtest-cline](https://github.com/avansaber/tailtest-cline)** -- Cline plugin (MCP-driven; reaches 8+ editors via Cline's host coverage)
See [tailtest.com/demo/claude-code](https://tailtest.com/demo/claude-code) for a live walkthrough of this variant, or [tailtest.com/comparison](https://tailtest.com/comparison) for a feature matrix across all four.
---
## License
MIT
© avansaber · MIT · avansaber/tailtest
