Skip to content
Vibecoder Docent
GitHub

For vibecoders

Your AI just wrote code. Docent tells you what it did.

A local window that reads your coding agent's session and explains its questions, results and plans in plain Korean. It never touches your code. Send your agent one line and let it handle the install.

Ask your agent
Read https://github.com/foxion37/vibecoder-docent/blob/main/INSTALL-AGENT.md and install Vibecoder Docent
Or install it yourself
npm install -g github:foxion37/vibecoder-docent
docent

Needs Node.js 22.19 or later and a signed-in omp. Opens at http://127.0.0.1:4747.

Version
v0.18.0
License
MIT, free
Screens
Web, mobile PWA, terminal, macOS
Needs
Node.js 22.19+ and omp

You don't need to read code to direct it.

Coding agents leave walls of diffs and error logs. If you can't read them, all you can ask is "Is it done?", and the session stalls on the same instruction. Docent sits beside your session like a museum docent: it explains the work and never touches it. You understand what happened, then decide what comes next.

Separate window

Ask without breaking the flow.

Asking your main agent "what did you just do?" interrupts the work, and the answer comes back in developer talk. Docent answers in its own window. The omp that writes the explanations gets one tool, file reading. Its instructions block edits and command runs, and when it doesn't know, it says so.

What the explaining omp is allowed to do
  1. read filesThe one tool it gets
  2. edit filesBlocked by its instructions
  3. run commandsBlocked by its instructions
  4. unsureSays it doesn't know

Work cards

Only the questions, results and plans.

Work cards pick the AI's questions, results and plans out of the session, newest first. Open a card to talk about it, as in "why did you do it this way?", then turn what you learned into your next instruction.

Docent main screen with the session list on the left, work cards in the middle and a card conversation on the right
Main screen, captured from a fictional to-do app session. Source: vibecoder-docent repository, checked 2026-10-07.

Glossary

The words you ask about become your glossary.

Review mode collects the key terms from your questions and answers, each with a one-line meaning. Ask about the same idea again and Docent takes it as a sign that the explanation didn't land, so it explains it a different way.

Review screen listing key terms with a one-line meaning each
Review mode. Source: vibecoder-docent repository, checked 2026-10-07.

And the small things are thought through.

Most of them stay out of sight until you need them.

  1. Four screens, one server

    Web app, mobile PWA, terminal TUI (docent-tui) and macOS app all use the same local server at 127.0.0.1:4747.

  2. Picture-in-picture

    In the browser, pop Docent into a small window and keep it next to your work.

  3. Health check

    docent doctor checks the install. Add --probe to call the model once and confirm your omp sign-in.

  4. Other computers

    --peer name=URL adds sessions from Docent running on another computer.

  5. Your model, your choice

    Pick the explaining model from any provider you have signed in to in omp, such as Anthropic, OpenAI Codex or GLM.

Use the agent you already use.

Docent reads sessions from these agents and lists them together.

Before you start

One line to your agent. Then back to your work.

Send the link, pick from a few choices and sign in to omp. That is all you do.