AI 에이전트와 나눈 대화를 로컬 위키로 정리하고 검색하는 도구입니다.

Claude Code, Codex CLI, Gemini CLI, claude.ai, ChatGPT 세션을 수집해 Obsidian 호환 Markdown 볼트로 저장하고, BM25 + 벡터 검색 + MCP + Web UI를 통해 다시 찾아볼 수 있게 합니다.

AI 에이전트를 오래 쓰다 보면 중요한 작업 기록이 여러 위치에 흩어집니다.

• Claude Code / Codex / Gemini 세션 로그
• ChatGPT / claude.ai export 파일
• 디버깅 과정
• 아키텍처 결정
• 임시 설계 메모
• “지난번에 어떻게 해결했더라?” 싶은 대화

seCall은 이 기록을 로컬에 모으고, 원본 transcript를 보존한 뒤, 그 위에 AI가 정리한 위키를 얹습니다.

검색은 CLI, Web UI, Obsidian, MCP 호환 AI 에이전트에서 모두 사용할 수 있습니다.

macOS:

curl -fsSL https://raw.githubusercontent.com/hang-in/seCall/main/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/hang-in/seCall/main/install.ps1 | iex

Linux는 아직 prebuilt 바이너리가 없습니다. Cargo 빌드를 사용하세요.

cargo install --path crates/secall --no-default-features

웹 UI까지 포함해 직접 빌드하려면 다음 도구가 필요합니다.

• Rust 1.75+
• Node 22
• pnpm 9
• just

git clone https://github.com/hang-in/seCall.git
cd seCall
just build
cp target/release/secall ~/.local/bin/

cargo install secall은 웹 UI 빌드를 자동 수행하지 않습니다. Web UI가 필요하면 Release 바이너리 또는 just build를 사용하세요.

대화형 초기화:

secall init

직접 경로 지정:

secall init --vault ~/Documents/Obsidian\ Vault/seCall
secall init --git git@github.com:you/obsidian-vault.git

초기화 과정에서 다음 항목을 설정합니다.

자동 감지:

secall ingest --auto

에이전트별 세션 경로 지정:

secall ingest ~/.codex/sessions
secall ingest ~/.gemini/sessions

claude.ai / ChatGPT export ZIP 수집:

secall ingest ~/Downloads/data-export.zip

전체 동기화:

secall sync

기본 BM25 검색:

secall recall "BM25 인덱싱 구현"

프로젝트, 에이전트, 날짜 필터:

secall recall "에러 처리" \
  --project seCall \
  --agent claude-code \
  --since 2026-04-01

벡터 검색:

secall recall "검색 파이프라인 동작 방식" --vec

LLM 쿼리 확장:

secall recall "검색 정확도 개선" --expand

REST API와 Web UI는 secall serve 하나로 실행합니다.

secall serve --port 8080

브라우저에서 접속:

http://127.0.0.1:8080

Web UI에서 할 수 있는 일:

REST API 엔드포인트 전체(검색 · 세션 메타 · 명령 · Job · SSE)는 API 레퍼런스 를 참고하세요.

MCP 호환 AI 에이전트(Claude Code, Cursor 등)에서 seCall 검색을 사용할 수 있습니다.

secall mcp                        # stdio 모드
secall mcp --http 127.0.0.1:8080  # HTTP 모드

제공 도구(recall / get / status / wiki_search / graph_query), MCP 클라이언트 설정, 세션 hooks 자동 동기화 예시는 API 레퍼런스 를 참고하세요.

seCall은 Obsidian 호환 Markdown 볼트를 사용합니다.

vault/
├── raw/
│   └── .sessions/
│       └── YYYY-MM-DD/
│           └── 원본 세션 Markdown
├── wiki/
│   ├── projects/
│   ├── topics/
│   └── decisions/
├── log/
│   └── YYYY-MM-DD.md
└── graph/
    └── graph.json

원본은 Markdown 파일입니다. DB는 파생 캐시입니다.

secall reindex --from-vault

위 명령으로 볼트에서 DB를 다시 만들 수 있습니다.

seCall 검색은 세 가지 계층으로 동작합니다.

query
  ├─ BM25 검색
  ├─ 벡터 검색
  └─ RRF 결합
       ↓
세션 다양성 제한
       ↓
최종 결과

Windows에서는 일부 기능이 fallback으로 동작합니다.

세션과 위키에서 관계를 추출해 그래프를 만듭니다.

secall graph build
secall graph stats
secall graph export

시맨틱 그래프 재구축:

secall graph rebuild --retry-failed
secall graph rebuild --since 2026-04-01
secall graph rebuild --session abc12345
secall graph rebuild --all

옵션 우선순위:

--session > --all > --retry-failed > --since

기본 위키 업데이트:

secall wiki update

백엔드 지정:

secall wiki update --backend claude
secall wiki update --backend codex
secall wiki update --backend haiku

특정 세션만 반영:

secall wiki update --session <id>

오프라인 / 수동 Git 모드:

secall wiki update --no-pull

위키 상태 확인:

secall wiki status

위키 생성은 도구 호출이 가능한 백엔드에서만 동작합니다.

리뷰 백엔드 지정:

secall wiki update --review --review-backend ollama
secall config set wiki.review_backend ollama

날짜별 작업 일기를 생성합니다.

secall log
secall log 2026-04-15

동작 방식:

1. 해당 날짜 세션 수집
2. 프로젝트별 그룹핑
3. Knowledge Graph에서 관련 토픽 추출
4. LLM으로 산문 정리
5. vault/log/{date}.md에 저장

LLM이 설정되지 않은 경우 템플릿 fallback을 사용합니다.

Git을 사용해 여러 기기에서 같은 볼트를 동기화할 수 있습니다.

secall sync

전체 sync 흐름:

init
  → pull
  → reindex
  → ingest
  → wiki_update
  → graph
  → push

로컬 전용 모드:

secall sync --local-only

그래프 생략:

secall sync --no-graph

위키 생략:

secall sync --no-wiki

secall lint

검사 규칙:

고아 볼트 파일 자동 정리:

secall lint --fix-orphan-vault

현재 설정 확인:

secall config show
secall config llm show

설정 변경:

secall config set output.timezone Asia/Seoul
secall config set search.tokenizer kiwi
secall config set embedding.backend ollama
secall config llm set log.backend haiku

설정 파일 경로 확인:

secall config path

Web UI에서 설정 편집:

secall serve --port 8080 --allow-config-edit

설정 파일 위치:

개발 서버 실행:

just dev

just dev는 다음 두 서버를 함께 실행합니다.

접속 방식:

빌드:

just build

수동 빌드:

cd web
pnpm install
pnpm build
cd ..
cargo build --release

개발 요구사항:

AI agent exports
  ├─ Claude Code JSONL
  ├─ Codex CLI JSONL
  ├─ Gemini CLI JSON
  ├─ claude.ai ZIP
  └─ ChatGPT ZIP
        ↓
ingest / normalize
        ↓
SQLite
  ├─ sessions
  ├─ turns
  ├─ FTS5
  ├─ vectors
  └─ graph metadata
        ↓
vault/
  ├─ raw/.sessions
  ├─ wiki
  ├─ log
  └─ graph
        ↓
interfaces
  ├─ CLI
  ├─ Web UI
  ├─ REST API
  ├─ Obsidian Plugin
  └─ MCP Server

아키텍처 이미지:

• LLM Wiki — LLM으로 원본 자료에서 점진적 지식 베이스를 만드는 패턴
• tobi/llm-wiki — LLM Wiki 구현 참고
• qmd — Markdown 파일용 로컬 검색 엔진
• graphify — 파일 폴더를 Knowledge Graph로 변환하는 접근

seCall은 AI 코딩 에이전트인 Claude Code와 Codex를 tunaFlow 멀티에이전트 워크플로우로 오케스트레이션하여 개발되었습니다.

전체 버전 · Phase 변경 이력은 CHANGELOG.md 에서 관리합니다.

AGPL-3.0