К основному содержанию
плагин

trail — плагин для Claude Code: что делает и как установить

Плагин подключает MCP-сервер trail к Claude Code для анализа локальных логов и запускает пошаговый сценарий отладки с обязательной очисткой добавленного кода.

MIT ★ 8 обновлён 2026-06-09

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install trail@claude-community
Открыть на GitHub

Что делает trail

Плагин автоматически настраивает MCP-сервер trail с инструментами list_sessions и get_logs. Сама утилита перехватывает вывод консольных команд или Docker-контейнеров в локальные JSONL-файлы. Фильтрация по уровням логов, регулярным выражениям, окнам времени и диапазонам строк происходит на стороне сервера, поэтому контекст Claude Code не засоряется лишними записями.

В плагин входит навык /trail:debug-with-trail. Он срабатывает на вопросы об ошибках или падениях сервиса и ведёт агента по четырём фазам: проверить захват процесса, изучить существующие логи, при необходимости точечно добавить временное логирование со специальной меткой и в конце обязательно удалить все правки, подтвердив очистку через grep.

Без бинарника trail в переменной окружения PATH плагин бесполезен — он отвечает только за интеграцию с Claude Code, а саму утилиту нужно ставить отдельно через официальный скрипт или команду go install.

Какие задачи решает

  • читать локальные логи сессий без перегрузки контекстного окна модели
  • находить причины падений сервисов и ошибок 500 в рантайме
  • добавлять временные маркеры отладки и автоматически зачищать их через grep
  • фильтровать вывод Docker-контейнеров по таймстемпам и регулярным выражениям

Примеры запросов агенту

  • /trail:debug-with-trail Разберись, почему сервер падает через пару минут работы
  • Покажи список сессий trail и найди ошибки в последнем запуске
  • Выясни, почему воркер перестал забирать задачи из очереди

Как установить trail

Через маркетплейс плагинов

/plugin marketplace add anthropics/claude-plugins-community
/plugin install trail@claude-community

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о trail

Как установить trail в Claude Code?

В интерфейсе Claude Code выполните команду /plugin marketplace add anthropics/claude-plugins-community, а затем запустите /plugin install trail@claude-community. Убедитесь, что утилита trail уже установлена в системе.

Что делает плагин trail?

Он регистрирует MCP-сервер для чтения логов и добавляет субагентский навык пошаговой отладки. Логи фильтруются на стороне сервера по регулярным выражениям или времени, поэтому в контекст модели попадают только нужные строки.

Что требуется для работы плагина на машине?

Плагину нужен установленный статический бинарник trail, доступный в переменной PATH. Его можно загрузить готовым скриптом с GitHub проекта или собрать командой go install github.com/Pratham-Mishra04/trail@latest.

Исходный текст

claude-code · MIT
# trail — Claude Code plugin

Auto-wires the [trail](https://github.com/Pratham-Mishra04/trail) MCP server into Claude Code and bundles a debugging skill that walks the agent through capturing → querying → cleanup of runtime instrumentation.

## What this gives you

- **Auto-registered MCP server** (`list_sessions`, `get_logs`) — no manual `claude mcp add` step
- **`/trail:debug-with-trail` skill** that triggers automatically when you ask about debugging, errors, crashes, or "what's happening at runtime", and follows a 4-phase workflow:
  1. Verify trail is installed and the right process is being captured
  2. Read existing logs first (cheapest answer)
  3. Add targeted log statements with a unique cleanup marker, restart, capture, query — only when needed
  4. **Mandatory cleanup** of every line added in step 3, verified by `grep`

## Prerequisites

The plugin only wires up Claude Code — you still need the `trail` binary on your `PATH`.

```bash
# macOS + Linux — prebuilt binary, no Go required
curl -fsSL https://raw.githubusercontent.com/Pratham-Mishra04/trail/main/install.sh | sh

# or, if you have Go:
go install github.com/Pratham-Mishra04/trail@latest
```

Verify:

```bash
trail version
```

## Install

Add the marketplace, then install the plugin:

```bash
# In Claude Code:
/plugin marketplace add Pratham-Mishra04/trail
/plugin install trail@pratham
/reload-plugins
```

That's it. The MCP server starts on the next session; the debug skill is auto-discoverable.

## Verify it's working

Inside Claude Code, ask:

> *List my trail sessions.*

You should see Claude invoke the `list_sessions` tool. If you have no sessions yet, capture one first:

```bash
trail run -- <your command>
```

Then try again.

## How the debug skill triggers

The skill auto-invokes when you ask things like:

- "Why is my server returning 500s?"
- "Help me debug this — it crashes after a few minutes"
- "What's in the logs from my last run?"
- "Trace why the worker isn't picking up jobs"

The skill body is verbatim instructions to the agent; you can read it at [`skills/debug-with-trail/SKILL.md`](./skills/debug-with-trail/SKILL.md).

## Don't want the plugin?

You don't need it — the binary works on its own. Manual setup for Claude Code:

```bash
claude mcp add trail -s user -- trail mcp
```

For Cursor / Windsurf / Claude Desktop, see the config snippets in the [main trail README](https://github.com/Pratham-Mishra04/trail#editor-setup).

The trade-off: without the plugin, you don't get the debug skill — the agent has to figure out how to use the MCP tools on its own from their descriptions. Usable, just less guided.

## Updating

The plugin uses the `version` field in `plugin.json`. To update after a new release:

```bash
/plugin update trail@pratham
```

## Local development

If you've cloned the trail repo and want to test plugin changes locally:

```bash
# In Claude Code:
/plugin marketplace add /path/to/trail
/plugin install trail@pratham
/reload-plugins
```

Then edit files under `integrations/claude-code/` and `/reload-plugins` to pick up changes.

© Pratham-Mishra04 · MIT · Pratham-Mishra04/trail

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
debugger NYCU-Chung Субагент debugger расследует ошибки и сбои: изучает логи, проверяет гипотезы и ищет первопричину. Запускайте его при падении тестов, регрессии или непонятном поведении приложения. CX Codex ★ 267звёзд репо containers Microsoft Плагин containers для GitHub Copilot управляет контейнерами и образами Docker или Podman. Показывает логи, слои образов и потребление ресурсов. ★ 11звёзд репо debug-openshell-cluster NVIDIA Скилл debug-openshell-cluster помогает диагностировать сбои шлюза OpenShell, проблемы со средами Docker, Podman и Kubernetes, а также ошибки запуска песочниц. CX Codex +1 739установок pod-doctor runpod Скилл pod-doctor находит причины сбоев в подах Runpod: ошибки 502, пропажу GPU после перезагрузки или зависание при старте. Диагностирует проблемы только в режиме чтения. CX Codex +1 3 700установок container-debugging aj-geddes Скилл container-debugging помогает разбирать сбои Docker-контейнеров: от проблем запуска и логов до сетевых ошибок и нехватки ресурсов. CX Codex +1 496установок elastic-package-cli elastic Скилл elastic-package-cli ведёт агента по командам elastic-package: формат, линт, сборка артефакта, pipeline- и system-тесты, локальный стек Elastic. CX Codex +1 515установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой