AI 코딩 에이전트로 작업하다 보면 금방 벽에 부딪힙니다. 화면에 diff와 에러 로그가 쌓이는데 코드를 읽지 못하면 “됐어요?”라고만 묻게 되고 같은 지시를 반복하다 세션이 멈춥니다. 바이브코더 도슨트는 singandmong이 이 벽을 없애려고 만든 설명 전용 창입니다. 작업 세션 옆에 붙여 두면 에이전트가 남긴 기록을 읽고 질문과 결과, 계획을 쉬운 한국어로 설명해 줍니다. 코드를 읽지 못해도 내가 시킨 일이 어떻게 됐는지 알고 다음 지시를 내릴 수 있습니다.

바이브코더 도슨트 메인 화면. 왼쪽에 세션 목록, 가운데에 작업 내용 카드, 오른쪽에 카드별 대화가 보인다 — 작업 내용 카드가 세션의 질문, 결과, 계획을 최신 순서로 보여 주는 메인 화면. 카드를 누르면 그 맥락에서 이어 물을 수 있다. 출처: 저장소 docs/assets(가상 작업 기록으로 촬영). 확인일: 2026-10-07.

주요 기능

작업 흐름을 끊지 않고 따로 물어볼 수 있습니다

메인 에이전트에게 “지금 뭐 한 거야?”라고 물으면 작업 흐름이 끊기고 답도 개발자 말투로 옵니다. 도슨트는 설명만 맡는 창을 따로 두어 이 문제를 없앴습니다. 이름 그대로 미술관 도슨트처럼 작품(코드)은 만지지 않고 설명만 합니다. 설명을 만드는 omp에는 파일 읽기 도구 하나만 주었습니다. 내부 지시문으로 수정과 실행을 막고 모르는 건 모른다고 답하게 해 두었습니다.

질문, 결과, 계획만 카드로 골라 보여 드립니다

작업 내용 카드는 세션에서 AI의 질문, 결과, 계획만 골라 최신 순서로 보여 줍니다. 카드를 누르면 그 카드에 대한 대화가 열려 “왜 이렇게 했어?”처럼 이어서 물을 수 있습니다. 이해한 내용을 바탕으로 에이전트에게 내릴 다음 지시를 정리하기 좋습니다.

물어본 단어는 용어 사전으로 쌓입니다

‘배운 내용 다시보기’는 문답에서 나온 핵심 단어를 한 줄 뜻과 함께 모아 용어 사전처럼 정리합니다. 같은 개념을 다시 물으면 아직 이해하지 못했다는 신호로 보고 설명 방식을 바꿉니다.

배운 내용 다시보기 화면. 문답에서 모은 핵심 단어가 한 줄 뜻과 함께 나열된다 — '배운 내용 다시보기' 용어 사전 화면. 출처: 저장소 docs/assets. 확인일: 2026-10-07.

쓰던 에이전트 그대로, 원하는 화면에서 봅니다

omp, Claude Code(서브에이전트 기록 포함), Codex CLI, Gemini CLI, pi의 세션을 한 화면에서 읽습니다. 화면은 웹앱, 모바일 PWA, 터미널 TUI(docent-tui), macOS 앱 네 가지이고 모두 같은 로컬 서버(127.0.0.1:4747)를 씁니다. 브라우저에서는 작은 창(PiP)으로 띄워 작업 화면 옆에 붙여 둘 수 있습니다. 설명 모델은 omp에 로그인한 공급자(Anthropic, OpenAI Codex, GLM 등) 중에서 고르면 됩니다.

시작하기

Node.js 22.19 이상이 필요하고 omp를 설치해 로그인해 두어야 합니다.

가장 쉬운 방법은 지금 쓰는 코딩 에이전트에게 설치를 맡기는 것입니다. 에이전트에게 아래 한 줄을 보내세요.

https://github.com/foxion37/vibecoder-docent/blob/main/INSTALL-AGENT.md 를 읽고 바이브코더 도슨트를 설치해줘

에이전트가 설치를 진행하면서 필요한 결정만 선택지로 묻습니다. 직접 설치하려면 README의 명령을 따르세요.

npm install -g https://github.com/foxion37/vibecoder-docent/releases/latest/download/vibecoder-docent.tgz
# 또는
npm install -g github:foxion37/vibecoder-docent
npx github:foxion37/vibecoder-docent    # npm
bunx github:foxion37/vibecoder-docent   # bun

설치한 뒤 docent를 실행하면 http://127.0.0.1:4747 이 열립니다. 설치 상태는 docent doctor로 점검할 수 있습니다. 라이선스는 MIT입니다.

사용 전 확인하세요

omp를 설치하고 로그인하지 않으면 설명이 나오지 않습니다. 설명을 만들 때마다 모델 호출 비용이 들며 앱에 표시되는 단가는 참고값일 뿐 실제 청구액이 아닙니다.

인증이 없고 기본으로 내 컴퓨터(127.0.0.1)에서만 열립니다. Tailscale로 다른 기기와 공유할 때는 신뢰하는 사설망에서만 쓰세요.

세션 기록은 omp를 거쳐 내가 설정한 LLM 공급자로 넘어갑니다. 전사에 비밀번호 같은 값이 섞여 있으면 그 값도 함께 넘어갈 수 있습니다.

미리 설명과 카드 선별의 일부는 TypeSafe Jev 키(TYPESAFE_API_KEY, 선택 사항)가 있어야 동작합니다. 키가 없으면 직접 묻는 방식으로만 쓸 수 있습니다.

macOS 앱은 직접 빌드해야 하며 서명과 공증을 거치지 않았습니다. 0.x 버전이라 기능이 자주 바뀝니다.

Claude Code나 omp를 쓰면서 출력이 벽처럼 느껴진다면 아래 링크에서 GitHub 저장소로 이동해 보세요. 에이전트에게 설치 링크 한 줄만 보내면 바로 시작할 수 있습니다.

바이브코더 도슨트, 내 AI가 지금 뭘 했는지 쉬운 한국어로 알려 주는 창