Citetrail

브라우저가 본 내용을 저장하는 로컬 기반 출처 추적 메모리 — 모든 회상에는 그것이 나온 URL, 제목, 타임스탬프가 함께 담깁니다.

Citetrail은 실제로 읽은 페이지를 캡처하여 사용자의 기기 안에 보관하고, 사용자와 사용자의 AI 에이전트가 MCP를 통해 검색할 수 있게 합니다. 에이전트가 여기서 찾은 내용을 사용할 때는 정확히 어디서 왔는지 인용할 수 있습니다.

• 상태: 프리릴리즈. 설치 전에 프로젝트 상태를 확인하세요.

• 라이선스: Apache-2.0

• 기본적으로 로컬. 계정도, 서버도, 업로드도 없습니다. 차단된 페이지는 fail-closed 방식으로 처리됩니다.

Citetrail이 해결하는 문제

여섯 개의 탭을 읽고 모두 닫았는데, 코딩 에이전트가 네 번째 탭에 있던 내용을 필요로 합니다. 현재 사용 가능한 방법은: 다시 붙여넣기, 에이전트가 열린 웹을 다시 검색하여 같은 페이지에 도달하기를 바라기, 또는 출처 없이 답을 받아들이기입니다.

브라우저 기록은 URL을 방문했다는 사실만 알지, 그 페이지가 무슨 내용이었는지는 모르고 에이전트에게 알려줄 수도 없습니다. Citetrail은 이 격차를 메웁니다:

Related MCP server: reprox-mcp

여기서 "출처 추적"이 의미하는 것

저장된 모든 조각에는 제한된 참조 정보가 포함됩니다: 원본 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를 전달하세요. 확장 프로그램의 압축 해제된 Chromium 어뎁터를 로드하려면 docs/extension.md를 참조하세요.

문서

자주 묻는 질문

내 AI 에이전트가 검색 기록을 검색하게 하려면 어떻게 하나요?

로컬 MCP 서버를 실행하고 에이전트에 등록하세요. 에이전트는 다른 MCP 도구와 마찬가지로 Citetrail에 쿼리하며 출처가 첨부된 조각을 받습니다. 에이전트는 브라우저나 프로필에 직접 접근할 수 없습니다.

내 데이터는 어디에 저장되며 업로드가 있나요?

내 기기에 있으며 언제든 삭제할 수 있는 로컬 데이터베이스에 저장됩니다. 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은 검토 게이트와 감사 추적을 통해 AI 에이전트와 인간 간의 핸드오프를 조정합니다. 두 프로젝트는 독립적이며 서로가 필수인 것은 아닙니다. 선택적 통합을 통해 특성 Citetrail 참조가 거버닝된 Runroom 작업을 지원할 수 있습니다.

기여

CONTRIBUTING.md와 CODE_OF_CONDUCT.md를 읽어주세요. 취약점은 비공개로 보고하세요 — SECURITY.md 참조.

프로젝트 상태

프리릴리즈, 1.0 이전입니다. 인터페이스는 변경될 수 있습니다. Citetrail은 다른 사람들이 이런 것이 필요한지 확인하려는 목적으로 공개되었습니다. — 이걸 시도한다면 어떤 것을 기억하려다 어떤 결과를 얻었는지 알려주세요.

라이선스

Apache License 2.0 라이선스. Copyright 2026 The Citetrail Contributors.