ONEDEV

obsidian-copilot

AI Agent OrchestrationEditorTypeScript

★ 7,708주당 +33조회 4

무엇인가

Copilot for Obsidian은 Obsidian 커뮤니티 플러그인으로, 볼트를 작업 디렉터리로 삼는 에이전트 클라이언트다. 자체적으로 모델을 실행하지 않고 opencode·Claude Code·Codex 같은 외부 에이전트 런타임을 붙여 노트 읽기, 파일 생성, 다중 턴 작업을 중계한다. TypeScript로 작성되며 Obsidian 플러그인 API 위에서 동작한다.

어떻게 동작하나

Agent가 기본 작업 단위다. opencode는 플러그인이 직접 내려받아 버전을 관리하고, Claude Code는 기존 설치 경로를 자동 탐지해 연결하며, Codex는 @agentclientprotocol/codex-acp 어댑터를 통해 붙는다. Claude Code와 Codex는 각자 CLI 로그인을 그대로 쓰고, opencode는 Copilot 호스팅 모델·자체 제공자 키·로컬 모델 중 하나로 라우팅한다. BYOK 키는 기기의 Obsidian Keychain에 저장되어 볼트의 data.json에 남지 않는다. Projects는 지침·재사용 컨텍스트·대화 기록을 묶고, Skills는 에이전트별로 켜고 끌 수 있으며, Commands는 `/`로 호출하는 저장된 프롬프트다.

무엇과 다른가

기존 Obsidian AI 플러그인이 선택 영역을 한 번 보내고 답을 받는 단발 채팅에 머무는 것과 달리, 여기서는 에이전트가 도구를 호출해 볼트에 파일을 만들고 여러 턴에 걸쳐 상태를 유지한다. 반대로 Claude Code나 Codex를 터미널에서 쓰던 흐름을 볼트 안으로 가져오는 쪽에 가깝다. 여러 Agent 탭을 동시에 열 수 있고, Plus 권한이 있으면 `@`로 설치된 에이전트 여러 개를 한 요청에 읽기 전용으로 지정할 수 있다.

어떻게 쓰나

설치는 Obsidian Community Plugins에서 플러그인을 추가한 뒤 Settings → Copilot → Basic → Agents에서 경로를 고른다. Download opencode, Claude Code Auto-detect, Codex 어댑터 설치 중 하나를 선택하고, Agent 리본 아이콘이나 Open Copilot Agent Chat Window 명령으로 창을 연다. Quick Ask는 노트를 벗어나지 않고 선택 영역에 대해 Quick Chat 모델로 질문하고 답을 교체·삽입·복사한다.

전제와 한계

Agent는 백엔드가 로컬 프로세스로 돌기 때문에 데스크톱 전용이다. 모바일에서는 Quick Chat, 커스텀 Commands, Quick Ask만 쓸 수 있다. 라이선스 없이도 자체 에이전트 계정·제공자 키·로컬 모델로 단일 에이전트 채팅, Markdown 컨텍스트 Projects, 커스텀 Skills/Commands, 로컬 Miyo 검색을 쓸 수 있고, Copilot 호스팅 모델과 클라우드 도구, 멀티 에이전트는 유료다. 노트는 볼트 파일로 남고 Miyo 인덱스는 기기에 남지만, 프롬프트와 포함된 컨텍스트는 선택한 모델·서비스로 전송되며 Copilot 호스팅 경로는 Brevilabs를 거친다. opencode Zen 무료 모델은 제공자가 프롬프트를 기록·학습할 수 있다는 경고가 표시된다.

관련 논문 4

유사 도구