Show GN: Obsidian 우측 사이드바에서 Claude Code,Codex를 실행하는 Vault Terminal 플러그인을 만들었습니다
(github.com/obst2580)Obsidian에는 기존 터미널 플러그인도 있지만, 제 Windows 환경에서는 Claude Code/Codex 같은 agent CLI를 쓰기에 PTY 동작, 스크롤, 색상, 특수 입력 처리에서 아쉬움이 있었습니다.
그래서 Obsidian 우측 사이드바에 실제 터미널을 띄우고, 현재 볼트 경로를 작업 디렉터리로 사용하는 Vault Terminal 플러그인을 만들었습니다.
Obsidian 노트에는 프로젝트 문서, 설계 메모, 작업 로그를 열어두고, 우측 터미널에서는 claude, codex, git, npm 같은 CLI를 바로 실행하는 흐름을 목표로 했습니다. Claude Code나 Codex CLI가 같은 볼트 안의 AGENTS.md, CLAUDE.md, 프로젝트 노트, 소스 파일을 기준으로 작업할 수 있습니다.
주요 기능은 다음과 같습니다.
Obsidian 우측 사이드바에서 터미널 실행
현재 볼트 경로를 기준으로 PowerShell, zsh, bash 실행
Claude Code, Codex CLI, git, npm, Python 같은 CLI 도구 실행
Windows/macOS 릴리스 ZIP 제공
Windows 기본 winpty 지원, 필요 시 ConPTY 전환
Obsidian 라이트/다크 테마에 맞춘 터미널 색상
Claude Code 멀티라인 입력을 위한 Shift+Enter 처리
긴 출력 확인을 위한 scrollback 및 강제 스크롤
TLS inspection proxy / 사용자 지정 CA 환경 설정 지원
아직 초기 베타입니다. 현재는 Obsidian Community Plugin 방식보다는 GitHub Release ZIP을 받아 볼트별로 설치하는 방식입니다. Node.js가 시스템에 설치되어 있어야 하고, Claude Code/Codex CLI도 VS Code extension이 아니라 터미널 명령으로 실행 가능한 상태여야 합니다.
GitHub:
https://github.com/obst2580/obsidian-powershell
Release:
https://github.com/obst2580/obsidian-powershell/releases
Windows/macOS 환경에서 Claude Code, Codex CLI 같은 agent CLI를 Obsidian과 함께 쓰는 분들의 피드백을 받고 싶습니다.
저는 홈서버(Ubuntu)에 Obsidian Vault를 넣어두고 SSH로 Claude Code를 사용합니다. Synthing으로 다른 노트북이나 PC에는 Vault만 동기화 하구요.
코드 같은 경우도 대부분은 홈서버에 넣어두고 Vault 폴더 내 md파일에 경로를 넣어둡니다.
-add-dir 명령으로 claude code를 실행하면 권한도 자동으로 줄 수 있어서 꽤 편해요.
터미널을 사이드바에서 쓰기에는.... 화면이 커야 속이 시원해서..
저는 듀얼 모니터 환경에서 한쪽 모니터에는 cmux로 여러 프로젝트의 agent를 돌리면서 개발하고, 관련 문서들은 해당 프로젝트의 Obsidian vault 경로에 배치해 두고 있습니다.
다른 모니터에서는 Obsidian을 띄워 문서를 보면서, claudian ↗ (https://github.com/YishenTu/claudian) 도구를 이용해 Obsidian 사이드 탭 채팅으로 문서 콘텐츠에 대해 공부하거나 질문하는 식으로 프롬프팅을 하고 있고요.
그래서 제안하신 도구를 이용해 프로젝트에 .obsidian 설정 파일만 넣어서 vault로 쓰게 되면, 옵시디언을 이제 Cursor나 Antigravity를 쓰는 것과 비슷한 느낌으로 활용할 수 있을 것 같네요