TraceDecay CLI
Локальный граф кода отвечает агентам на вопросы о символах и вызовах, и они реже перечитывают файлы целиком.
- 86 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Фоновая служба и хуки агента работают на вашей машине и читают весь репозиторий.
- Установка выполняет скачанный скрипт, а инструмент правок способен менять файлы проекта.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/ScriptedAlchemy/tracedecay/master/install.sh | bashПервая команда установки из README для Linux и macOS на Apple silicon. Для Windows архив скачивают из релиза.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Фоновая служба и хуки агента работают на вашей машине и читают весь репозиторий.
- Установка выполняет скачанный скрипт, а инструмент правок способен менять файлы проекта.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
TraceDecay строит семантический граф репозитория на вашей машине. Агент обращается к нему через MCP-инструменты `tracedecay_context`, `tracedecay_search`, `tracedecay_callers` и `tracedecay_impact`: находит символы, цепочки вызовов, затронутые функции, документацию и фрагменты исходников. Раньше для этого приходилось гонять `grep` и читать файлы целиком. Кроме поиска, в наборе есть карта тестов, оценка состояния кода и правки с привязкой к якорям. Фоновая служба следит за свежестью индекса, учитывает ветки и рабочие деревья git. Локальная панель показывает сохраненный контекст, сессии и экономию токенов.
Для кого. Разработчикам с большими репозиториями, где агент тратит много токенов на поиск нужного кода.
Подходит, если
- Агент в Claude Code или Cursor долго ищет, кто вызывает функцию.
- Перед рефакторингом хочется увидеть, какие тесты и файлы заденет правка.
- Монорепозиторий велик, и чтение файлов съедает контекст еще до работы.
- Над одним проектом идут несколько веток git, и агент должен понимать, в какой он.
Не подходит, если
- Репозиторий маленький, и агенту хватает обычного поиска по файлам.
- Политика запрещает фоновые службы и установку бинарных файлов.
- Язык проекта не входит в собранные расширения разбора.
Пример запроса к агенту
Покажи через граф кода, кто вызывает функцию парсинга конфигурации и какие тесты заденет ее изменение.Ограничения
Установщик из README скачивает и запускает скрипт, а после проверяет подпись архива через `gh attestation verify`. Без GitHub CLI установка прервется, пока вы не разрешите вариант с проверкой только контрольной суммы. Перед `tracedecay init` нужна работающая служба: без нее команда отказывается писать что-либо. Сразу после `init` индекс может быть еще не готов, поэтому проверяйте `tracedecay status` или добавляйте `--wait`. Состав поддерживаемых языков задает `Cargo.toml` проекта, а сборка из исходников требует Rust nightly.
Как отключить. Удалите настройки агента, которые записал `tracedecay install`, и остановите фоновую службу. Папку индекса проекта и сам бинарный файл удалите отдельно.
Частые вопросы
Как подключить TraceDecay к агенту?
Выполните `tracedecay install`: команда сама находит поддерживаемые агенты. Для одного агента добавьте `--agent`, например `--agent codex`, а для проекта без глобальных правок `--local`. После этого перезапустите агента.
Какие агенты поддерживаются?
README называет Claude Code, Codex, Cursor, Hermes, Kiro, Kimi Code, OpenCode и семейство Cline.
Что делать, если после init статус показывает неготовый индекс?
Подождите или запустите `tracedecay init --wait`: команда блокируется, пока первая версия индекса не соберется. Состояние смотрите через `tracedecay status`.
Данные уходят в облако?
По умолчанию нет: хранилище локальное. Настроенные удаленные источники работают по явной политике, а не по умолчанию.
Как проверить, что установка исправна?
Запустите `tracedecay doctor`: команда только читает состояние и сообщает о проблемах. Список всех MCP-инструментов покажет `tracedecay tool`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер и CLI на Rust: граф вызовов и гибридный семантический поиск по коду для Claude Code и Codex
Локальный MCP-сервер с графом вызовов и поиском символов: агент видит структуру кода и последствия правки заранее.
CodeGraph на Rust
codegraph-rust
Граф кода для агента на Rust: четыре MCP-инструмента показывают, что заденет правка, как устроена архитектура и где хрупкие места проекта
Локальный граф знаний о коде с историей версий: MCP-сервер отвечает агенту, кто вызывает функцию и что сломается от правки
Локальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
Rust-бинарник для агентов и терминала: через tree-sitter находит определение символа, его вызовы и зависимости файла
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| TraceDecay (эта карточка) | нет | 86 | ||
| code-index-mcp | нет | не нужна | 162 | ищет и индексирует код через MCP; TraceDecay добавляет граф вызовов, карту тестов и фоновую службу |
| Serena | нет | не нужна | 31 335 | дает агенту символьную навигацию на языковых серверах; TraceDecay строит собственный локальный граф на tree-sitter |
Коротко о README
Репозиторий описывает установку службы, подключение к агентам и команды `status`, `tool`, `dashboard`, `monitor` и `doctor`. Отдельно разобрана модель хранения второй версии.