Citetrail

Локальная память с подтверждённым происхождением о том, что видел ваш браузер — каждое воспоминание несёт URL, заголовок и временную метку, откуда оно взялось.

Citetrail захватывает страницы, которые вы действительно читали, хранит их на вашем компьютере и делает их доступными для поиска — вами и вашими ИИ-агентами через MCP. Когда агент использует что-то, что он там нашёл, он может точно указать, откуда это взялось.

• Статус: предрелизная версия. Перед установкой см. Статус проекта.

• Лицензия: Apache-2.0

• Локально по умолчанию. Никакого аккаунта, сервера и загрузок. Заблокированные страницы не сохраняются (fail closed).

Проблема, которую решает Citetrail

Вы открыли шесть вкладок, закрыли их, и теперь вашему агенту-программисту нужна информация из четвёртой вкладки. Ваши варианты сегодня: вставить её снова, позволить агенту заново искать в открытом интернете и надеяться, что он попадёт на ту же страницу, или принять ответ без источника.

История браузера знает, что вы посетили URL. Она не знает, что было на странице, и не может сообщить это вашему агенту. Citetrail устраняет этот разрыв:

Related MCP server: qsearch

Что здесь означает «подтверждённое происхождение»

Каждый сохранённый фрагмент хранит ограниченную ссылку: исходный URL, заголовок страницы, временную метку захвата и позицию на странице. При извлечении возвращается фрагмент и эта ссылка вместе — их нельзя разделить. Агент, отвечающий из Citetrail, всегда может сказать, откуда он это взял, а вы всегда можете открыть оригинал.

Если источник исчез, Citetrail сообщает, что источник исчез. Он не выдаёт фрагмент за актуальный, как будто он всё ещё доступен.

Быстрый старт

git clone https://github.com/anonb3ll/citetrail
cd citetrail
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/citetrail init

# 2. Search the local store
.venv/bin/citetrail search "retry backoff"

# Optional: block a sensitive hostname before it can be stored
.venv/bin/citetrail block bank.example.test

# 3. Point an agent at the same local store over MCP
.venv/bin/citetrail mcp --stdio

Хранилище по умолчанию — ~/.local/share/citetrail. Установите CITETRAIL_STORE или передайте --store PATH, чтобы использовать другую локальную директорию. См. docs/extension.md, чтобы загрузить распакованный адаптер Chromium.

Документация

Часто задаваемые вопросы

Как разрешить моему ИИ-агенту искать в истории браузера?

Запустите локальный MCP-сервер и зарегистрируйте его у своего агента. Агент обращается к Citetrail как к любому другому MCP-инструменту и получает фрагменты с прикреплёнными источниками. Он никогда не получает прямого доступа к вашему браузеру или профилю.

Где хранятся мои данные и загружается ли что-то?

На вашем компьютере, в локальной базе данных, которую вы можете удалить в любой момент. У Citetrail нет сервера, и он ничего не загружает. См. docs/privacy.md.

Как запретить захват моего банка, почты или рабочей интрасети?

Чёрный список. Он проверяется перед захватом и блокирует по умолчанию — если правила не могут быть оценены для страницы, эта страница не захватывается. Добавьте хост с помощью citetrail block bank.example.test. Захват только по белому списку отложен.

Может ли агент цитировать источник, который он на самом деле не читал?

Не из Citetrail. Ссылка путешествует вместе с фрагментом; не существует API, который возвращает текст без его происхождения.

Что произойдёт, если я офлайн или страница исчезла?

Поиск работает офлайн по уже захваченным данным. Если исходный URL недоступен, результаты помечаются как таковые, а не молча выдаются за актуальные. Недоступные и заблокированные по соображениям конфиденциальности состояния честно сообщаются, а не скрываются.

Это приложение для заметок или «второй мозг»?

Нет. Citetrail захватывает и извлекает; он не организует ваше мышление, не строит граф знаний и не требует от вас ничего поддерживать. Это инфраструктура для инструментов, которым нужно знать, что вы читали.

Работает ли это в любом браузере?

Расширение в первую очередь ориентировано на браузеры на основе Chromium. Нативный мост между расширением и локальным сервисом имеет реальные ограничения — см. docs/limitations.md.

Чем Citetrail не является

• Не облачный сервис и не сервис синхронизации. Один компьютер — одно хранилище.

• Не система PKM и не заметки.

• Не клинический инструмент, не инструмент для благополучия и не отслеживания внимания. Он не делает никаких заявлений о вашем когнитивном состоянии.

• Не парсер. Он захватывает страницы, которые вы сами посетили, по вашим правилам.

• Не мобильное приложение.

См. docs/limitations.md и docs/private-exclusions.md.

Связанный проект

Runroom координирует передачу задач между ИИ-агентами и людьми с помощью контрольных точек проверки и аудиторского следа. Оба проекта независимы, и ни один не требует другого; опциональная интеграция показывает ссылку Citetrail, передаваемую в управляемую задачу Runroom.

Участие

Прочтите CONTRIBUTING.md и CODE_OF_CONDUCT.md. Сообщайте об уязвимостях конфиденциально — см. SECURITY.md.

Статус проекта

Предрелизная версия, до 1.0. Интерфейсы будут меняться. Citetrail опубликован, чтобы выяснить, нужен ли он другим людям — если вы попробуете, расскажите нам, что вы пытались вспомнить и получилось ли у вас.

Лицензия

Apache License 2.0. Авторские права 2026, участники Citetrail.