ObsDog Docs · Overview

문서를 저장하는 도구에서,
지식을 개선하는 시스템으로.

ObsDog은 사람과 AI가 함께 쓰는 로컬 우선 지식 저장소입니다. 무엇이 존재하는지만 보여주지 않고, 무엇이 검색되고 노이즈였으며 실제로 사용되고 유용했는지 측정합니다.

Quick Start · 설치하기
Local first Block native Human + AI
Landscape

기존 도구 사이의 빈틈을 연결합니다.

ObsDog은 문서 편집기나 LLM trace 도구를 단순히 복제하지 않습니다. 지식 자체와 그것이 실제 작업에서 사용된 증거를 같은 생명주기로 연결합니다.

서비스잘하는 것ObsDog이 연결하는 지점
로컬 지식 그래프Obsidian

Markdown, 링크, 플러그인 기반 개인 지식 관리

검색 노출·사용·유용성 측정은 핵심 범위가 아님

작성, 공유, 권한, 페이지 분석과 팀 워크플로

블록 리비전과 AI 검색 근거를 하나의 관측 사슬로 다루지 않음

모델 호출, retrieval trace, dataset과 evaluation

사람이 관리하는 지식의 장기 이력과 유지보수가 중심은 아님

지식 관측ObsDog

문서·블록·검색·사용·평가·수정을 같은 identity로 연결

로컬 CLI는 공개 무료 베타이며 클라우드는 한도 내 제한 가입

Why it is different

특별한 점은 기능 하나가 아니라 연결 방식입니다.

Stable knowledge identity

문서 안의 중첩 블록이 이동·수정돼도 identity와 lineage를 유지합니다.

Evidence, not inference

검색됐다는 이유만으로 사용됐거나 유용했다고 추정하지 않습니다.

Feedback becomes maintenance

유용함, 비유용, 노이즈, 검증 상태와 이유가 실제 업데이트 큐로 이어집니다.

Humans and AI, explicitly

사람·Agent·시스템·평가자의 행동과 판단을 섞지 않고 기록합니다.

Measurement contract

다섯 상태를 구분해야 지식 품질을 설명할 수 있습니다.

  1. 01
    retrieved

    검색 후보로 반환

  2. 02
    exposed

    화면 또는 Agent 문맥에 노출

  3. 03
    selected

    의도적으로 선택

  4. 04
    used

    인용·복사·링크 등으로 사용

  5. 05
    useful

    작업에 도움이 됐다고 평가

각 상태는 독립적인 관측입니다. exposed는 used가 아니고, used는 useful을 보장하지 않습니다. CLI v0.2.0의 Living memory는 같은 검색 맥락·현재 리비전의 실제 사용과 평가로 활성도를 강화하고 시간에 따라 감쇠합니다. 기본 검색 영향은 ±20% 이내이며 --ranking lexical로 기준선을 볼 수 있습니다. 미사용은 나쁨이 아니고 원문을 삭제하지 않습니다. 웹 지식 지도는 문서에 작성된 참조만 연결로 표시합니다. 검색·사용에 따른 활성도는 대시보드에서 별도로 확인합니다.

Source-aware care

원본은 제자리에, 판단에는 근거를.

유지되는 정본이 코드·저장소 문서에 있다면 그곳에 남깁니다. ObsDog에는 필요한 포인터·종합·허용된 사본만 둡니다. AI가 현재 리비전을 읽고 필요한 부분만 고친 뒤 출처·문서화 평가를 별도 메타데이터로 남깁니다. 사람은 Wiki·지식 지도·대시보드에서 상태와 근거를 봅니다.

native

Space 자체의 결정·재사용 가능한 지식

pointer

유지되는 원본과 답할 수 있는 질문 안내

derived

출처를 명시한 추가 종합·학습

snapshot

버전과 한계가 명시된 허용된 사본

current·historical·working은 지식의 목적입니다. 과거 맥락을 기본 답과 구분하되 리비전·감사 이력을 삭제하지 않습니다. home·fidelity·applicability·context·connections를 이유·근거와 함께 평가하고, 미확인·해당 없음·미평가는 통과와 구분합니다. 이 평가는 검색 결과의 실제 유용성과 다릅니다.

obsdog care show --format json
obsdog search --source-role pointer --temporal current "installation"
obsdog care record --file care.json --actor-type agent --actor your-agent --format json

CLI v0.2.0 / 서버 v0.1.26 이상이 필요합니다. 같은 요청 ID의 동일 재시도는 중복되지 않고, 수정으로 리비전이 바뀌면 예전 판단은 이전 리비전으로 남습니다. 동시 판단은 충돌로 보존합니다. 자동 크롤러·백그라운드 AI·랭킹 강화·자동 삭제는 켜지지 않습니다.

JSON 형식과 안전한 AI 워크플로
Local setup

CLI와 AI 플러그인을 한 번에 준비하세요.

Apple silicon macOS 또는 Linux x64에서 Codex·Claude Code를 선택해 CLI와 플러그인을 함께 준비합니다. 호환되는 기존 CLI는 재사용하며, 로컬 데이터는 ~/.obsdog에 남습니다.

추천 · CLI + AI 플러그인

한 번에 준비하고, 로컬 지식을 확인하세요.

Apple silicon macOS · Linux x64. 선택한 Agent CLI(Codex 또는 Claude Code)가 필요합니다. ObsDog CLI가 없으면 macOS는 Homebrew, Linux는 독립 설치기를 사용합니다.

Codex
curl -fsSL https://obsdog.ai/install.sh | sh -s -- --client codex
Claude Code
curl -fsSL https://obsdog.ai/install.sh | sh -s -- --client claude

설치 후 obsdog version과 obsdog document list로 CLI를 확인하고, 새 Agent 세션에서 ObsDog find를 호출하세요. 빈 목록은 정상입니다.

obsdog version
obsdog document list
obsdog dashboard serve

실행되는 설치 스크립트 확인 · 공식 진입점 확인 · Agent 사용 가이드

CLI만 사용해도 됩니다

플러그인 없이도 시작

macOS는 Homebrew, Linux x64는 독립 설치기로 CLI만 설치할 수 있습니다. macOS용 독립 설치기도 릴리스에 있습니다. 두 방식을 중복 설치하지 마세요.

macOS · Homebrew
brew install obsdoghq/tap/obsdog
obsdog document list
Linux x64 · 독립 설치
curl -fsSL https://github.com/obsdoghq/obsdog-releases/releases/latest/download/install.sh | sh

Linux 로컬 사용에는 GUI나 계정이 필요 없습니다. Linux에서 클라우드에 로그인하려면 잠금 해제된 Secret Service 세션이 필요합니다.

프로젝트 init은 필요 없습니다. 같은 Personal Space를 어느 폴더에서든 쓰며, 데이터는 ~/.obsdog에 남습니다. 설치 과정에서 문서를 만들거나 클라우드에 올리지 않습니다.

Homebrew 업데이트: brew upgrade obsdoghq/tap/obsdog. 독립 설치 업데이트: obsdog update. 실행 중인 MCP와 로컬 대시보드는 업데이트 후 종료·재시작해야 합니다. 플러그인 단독 설치는 CLI를 설치하지 않습니다.

최신 CLI 릴리스와 독립 설치기

클라우드는 정원·사용량 한도가 있는 제한 베타이며 가입이 일시 중단될 수 있습니다. macOS 데스크탑 앱은 아직 공개 배포하지 않습니다.

init과 경로 기반 Space 옵션은 제거했습니다. 기본 Personal은 어느 폴더에서든 같습니다. 설치는 문서를 생성하거나 동기화하지 않습니다. 전역 Agent 지침은 자동으로 바꾸지 않으며 선택 안내에서 검토할 수 있습니다.

첫 지식은 선택해서 가져오세요.

GitHub·Slack·레포가 연결돼 있어도 설치만으로 읽거나 올리지 않습니다. AI에게 먼저 권한 있는 원본에서 재사용 가능한 후보와 저장할 Space·출처·검증 시점을 제안하게 하고, 선택한 것만 가져오세요. 정본 문서는 원래 위치에 둡니다.

ObsDog 첫 지식을 준비하고 싶어. 아직 가져오지는 말고, 내가 허용한 원본에서 재사용할 만한 노트/원본 포인터를 최대 5개 제안해줘. 각각 출처·검증 시점·저장할 Space·개인정보 경계를 적고, 내가 선택한 뒤에만 저장해.
부트스트랩 가이드 자세히 보기
Personal free beta

로컬 지식은 무료. 연결은 한도 안에서.

정원·사용량 한도를 유지한 제한 가입을 받고 있습니다. 결제수단을 받지 않으며 자동 유료 전환은 없습니다. 정원에 도달하면 가입이 일시 중단될 수 있습니다.

Local$0

계정 없이 CLI에서 문서를 저장하고 검색·평가하세요. 로컬 사용량에는 서비스 한도가 없습니다. 별도 Mac 앱 공개 배포는 준비 중입니다.

데이터는 기기에 저장
Personal free beta$0
  • Personal Space 1개
  • 연결 기기 세션 3개
  • 클라우드 보관량 500 MiB
  • 월 동기화 작업 10,000건
초기 정원 100명 · 호스팅 AI 크레딧 없음

보관량은 이력·측정·동기화 사본을 포함합니다. 월 한도는 UTC 기준 매월 1일 초기화되며 같은 작업 재전송은 중복 차감하지 않습니다. 한도에 도달해도 읽기·내보내기·로컬 작업은 유지됩니다. 새 Organization 생성과 유료 플랜은 추후 제공 예정입니다.

Product status

로컬 개인 사용부터 제대로 시작합니다.

현재 기반
  • SQLite·FTS5 기반 계정 없는 로컬 CLI
  • 안정적인 블록·리비전·라벨·코멘트
  • 검색 trace·네 가지 평가·백업/복원
  • 명시적 Personal 동기화·이력 보존 통합
  • 인증된 웹 Wiki·지식 지도·오프라인 캐시
다음 단계
  • 신규 계정·독립 외부 네트워크 베타 검증
  • 웹 탐색·지식 유지보수 UX 개선
  • 팀 협업 워크플로 검증
  • Mac·iOS 앱은 웹 UX 확정까지 보류

로컬 CLI와 Homebrew 패키지는 공개 무료 베타입니다. 호스팅 앱은 정원·사용량 한도를 유지한 제한 가입을 받고 있습니다. 외부 신규 계정 검증은 진행 중입니다. 결제·공개 데스크탑 앱은 제공하지 않습니다.

Observable Docs

지식의 양이 아니라 작동 여부를 보세요.

실제 Personal Space에서 검색 품질, 노이즈, 유용성, 지식 상태가 어떻게 연결되는지 확인할 수 있습니다.

대시보드 살펴보기