ThirdBrain

🇺🇸 English | 🇰🇷 한국어

ThirdBrain

Turn your notes into a contradiction-free knowledge graph.

ThirdBrain is an Obsidian plugin that extracts propositions from your writing, builds a logical knowledge graph with typed edges, detects contradictions, and analyzes connections — all locally using your choice of AI provider.

---

Features

✦ Graph Generation

Paste or drop any text. ThirdBrain runs a multi-stage pipeline that builds three layers of structured knowledge:

10 logical relation types across 4 axes:

Auto-connection to your existing graph: After the pipeline runs, ThirdBrain automatically scans your existing knowledge graph and proposes edges between the new nodes and your saved notes — surfacing connections you didn't know existed.

Contradiction handling: When a new proposition conflicts with existing knowledge, ThirdBrain flags it immediately with a conflicts_with edge and presents three resolution options: discard one proposition, discard the other, or introduce a parent premise that encompasses both. No contradiction is silently buried.

🔍 Folder Analysis

Select any folder and get a synthesized insight report — not just a summary of connections, but concrete conclusions derived from the logical structure. Supports intent presets (core insight, contradiction detection, action extraction, etc.) and optional _actions subfolder inclusion.

⊕ Graph

Open Obsidian's native graph view filtered to any folder for visual exploration.

🌉 Bridge

Find structural bridges between two folders — cross-domain connections your notes imply but haven't made explicit.

Action Layer

Actions extracted from your notes are stored in _actions/ subfolders, linked back to the propositions that motivated them.

---

AI Provider Setup

ThirdBrain supports three AI backends. Set your preferred provider on first launch or in Settings → ThirdBrain.

All AI calls happen locally from your machine. No data is sent to any ThirdBrain server.

---

Installation

Community Plugins (recommended)

1. Open Obsidian → Settings → Community plugins → Browse
2. Search for ThirdBrain
3. Install and enable

Manual

1. Download main.js, manifest.json, and styles.css from the latest release
2. Copy to {vault}/.obsidian/plugins/thirdbrain/
3. Enable in Settings → Community plugins

---

Usage

1. Open the ThirdBrain panel (click the sootball icon in the ribbon, or run Open ThirdBrain panel from the command palette)
2. Paste text into the input area and click ✦ Generate to run the pipeline
3. Click ⊕ Graph to open the filtered graph view for any folder
4. Click 🔍 Analyze to get a synthesized insight report for a folder
5. Click 🌉 Bridge to find cross-folder connections

---

Requirements

• Obsidian 1.4.0+
• Desktop only (uses local AI CLI or network API calls)
• One of: Gemini API key, Anthropic API key, or Claude Code CLI

---

Enterprise Use Cases

ThirdBrain's architecture — typed logical edges, absolute source traceability, and contradiction detection — maps directly onto high-stakes organizational problems.

Absolute Traceability from Idea to Code

Every business decision leaves a verifiable trail. Drop a product spec or domain document into ThirdBrain: it's archived as-is in raw/, decomposed into propositions with exact source spans, and linked to the development actions that implement them via implements edges. When a developer writes code, they can trace it back — without ambiguity — to the business proposition that demanded it, and to the original paragraph that proposition came from.

Works today. Ingest your PRD, let ThirdBrain extract propositions, then create action nodes for each sprint task. The implements link is the audit trail.

Semantic Collider — Cross-Domain Contradiction Detection

Different teams use different words for the same concepts, or the same words for conflicting ones. Feed documents from two domains (e.g. engineering specs and security policy) into separate folders, then run Bridge between them. ThirdBrain surfaces the structural connections your teams haven't made explicit — and the conflicts_with edges reveal where the two bodies of knowledge are on a collision course before anyone writes a line of code.

Works today via the Bridge feature. Cross-folder analysis finds implicit agreements and contradictions across organizational silos.

Logical API Gatekeeper — Contradiction-Driven Requirements Review

Build a master graph of your core architecture decisions and non-negotiable principles. When a new feature request or policy change arrives, ingest it. If it generates a conflicts_with edge against the master graph, the system surfaces the exact proposition it contradicts and demands resolution — not negotiation by exhaustion, but resolution by logic.

Works today as a workflow. Automated rejection (blocking ingestion on conflict) is a planned extension.

---

License

MIT

---

---

🇺🇸 English | 🇰🇷 한국어

ThirdBrain — 한국어

노트를 모순 없는 지식 그래프로.

ThirdBrain은 Obsidian 플러그인입니다. 글에서 명제를 추출하고, 논리적으로 유형화된 엣지로 지식 그래프를 구축하며, 모순을 감지하고 연결을 분석합니다 — 모두 로컬에서, 원하는 AI 제공자로.

---

기능

✦ 그래프 생성

텍스트를 붙여넣거나 드롭하세요. ThirdBrain이 단계별 파이프라인으로 세 가지 지식 레이어를 구축합니다.

4축 10가지 논리 관계 유형:

기존 그래프와 자동 연결: 파이프라인이 완료되면 ThirdBrain이 기존 지식 그래프를 자동으로 스캔하여 새 노드와 저장된 노트 사이의 엣지를 제안합니다 — 미처 발견하지 못했던 연결을 수면 위로 드러냅니다.

모순 처리: 새로운 명제가 기존 지식과 충돌하면 ThirdBrain이 conflicts_with 엣지로 즉시 표시하고 세 가지 해소 옵션을 제시합니다: 한쪽 명제 폐기, 다른 쪽 폐기, 또는 두 모순을 포괄하는 상위 전제 추가. 어떤 모순도 조용히 묻히지 않습니다.

🔍 폴더 분석

폴더를 선택하면 단순한 연결 요약이 아니라 논리 구조에서 도출된 구체적인 결론을 담은 종합 인사이트 리포트를 생성합니다. 분석 목적 프리셋(핵심 파악, 모순 탐지, 액션 추출 등)과 _actions 하위 폴더 포함 여부를 선택할 수 있습니다.

⊕ 그래프

Obsidian 네이티브 그래프 뷰를 특정 폴더 기준으로 필터링해 시각적으로 탐색합니다.

🌉 연결

두 폴더 사이의 구조적 연결 고리를 찾습니다 — 노트가 암시하고 있지만 아직 명시하지 않은 크로스 도메인 연결을 발견합니다.

액션 레이어

노트에서 추출된 액션은 _actions/ 하위 폴더에 저장되며, 이를 동기화한 명제와 연결됩니다.

---

AI 제공자 설정

ThirdBrain은 세 가지 AI 백엔드를 지원합니다. 최초 실행 시 또는 설정 → ThirdBrain에서 원하는 제공자를 선택하세요.

모든 AI 호출은 사용자 기기에서 직접 이루어집니다. ThirdBrain 서버로 데이터가 전송되지 않습니다.

---

설치

커뮤니티 플러그인 (권장)

1. Obsidian → 설정 → 커뮤니티 플러그인 → 탐색
2. ThirdBrain 검색
3. 설치 후 활성화

수동 설치

1. 최신 릴리즈에서 main.js, manifest.json, styles.css 다운로드
2. {볼트 경로}/.obsidian/plugins/thirdbrain/ 폴더 생성 후 복사
3. 설정 → 커뮤니티 플러그인에서 활성화

---

사용법

1. ThirdBrain 패널 열기 (리본의 숯볼 아이콘 클릭, 또는 커맨드 팔레트에서 Open ThirdBrain panel 실행)
2. 입력 영역에 텍스트를 붙여넣고 ✦ 생성 클릭 → 파이프라인 실행
3. ⊕ 그래프 로 폴더 그래프 뷰 열기
4. 🔍 분석 으로 폴더 종합 인사이트 리포트 확인
5. 🌉 연결 로 폴더 간 브릿지 탐색

---

요구 사항

• Obsidian 1.4.0 이상
• 데스크톱 전용 (로컬 AI CLI 또는 네트워크 API 호출 사용)
• 다음 중 하나: Gemini API 키, Anthropic API 키, 또는 Claude Code CLI

---

엔터프라이즈 활용

ThirdBrain의 아키텍처 — 유형화된 논리 엣지, 완전한 출처 역추적, 모순 감지 — 는 조직의 고위험 문제에 그대로 적용됩니다.

아이디어에서 코드까지 완전한 역추적

모든 비즈니스 의사결정이 검증 가능한 흔적을 남깁니다. 제품 기획서나 도메인 문서를 ThirdBrain에 넣으면: 원본이 raw/에 그대로 보존되고, 정확한 출처 구절과 함께 명제로 해체되며, implements 엣지로 이를 구현하는 개발 액션과 연결됩니다.

지금 바로 사용 가능. PRD를 인제스트하고 각 스프린트 태스크에 액션 노드를 생성하세요. implements 링크가 감사 추적이 됩니다.

시맨틱 콜라이더 — 크로스 도메인 모순 검증기

두 도메인(예: 개발팀 기획서와 보안팀 정책)의 문서를 각각 다른 폴더에 인제스트한 뒤 브릿지를 실행하세요. conflicts_with 엣지로 코드를 한 줄 쓰기 전에 충돌 지점을 드러냅니다.

지금 바로 사용 가능. 브릿지 기능이 조직 사일로 간 암묵적 합의와 모순을 동시에 찾아냅니다.

논리적 API 게이트키퍼 — 모순 기반 요구사항 검토

핵심 아키텍처 결정으로 마스터 그래프를 구축하세요. 새로운 기능 요청이 들어오면 인제스트합니다. 마스터 그래프에서 conflicts_with가 생성되면 정확히 어떤 명제와 충돌하는지 제시하고 해소를 요구합니다.

지금 워크플로우로 가능. 자동 거부는 추후 지원 예정입니다.

---

라이선스

MIT