mdtation
GitHub

terminal markdown viewer for agent workflows

A better agentic feedback flow.

Your agent writes a spec. You now comment on the exact section, inline. The agent reads it instead of long conversation chunks.

$ npm i -g mdtation
GitHub
works with anything that can CLI, or you paste manually
Claude CodeCodex CLICursor CLIAmpCopilot CLI

You just left a comment. Now the agent can read it.

inspiration and friends

“If herdr, hunk, and agentation had a baby.”

mdtation combines ideas and flows from a few great tools.

herdrGitHub
The multiplexer that you maybe already use. Keyboard-first but mouse-ready.
hunkGitHub
Diff review with a comment flow built for agents. mdtation is hunk for markdown.
agentationGitHub
Click a website element to tell your agent exactly which part of a page you mean. This inspired our flow.
OpenTUIGitHub
The terminal renderer we use, the same one OpenCode and hunk are built on.

the problem today

Giving feedback in a long conversation is awkward

option pickers
no box for your real answer
label replies
answering findings from memory
scrollback plans
your thoughts on line 140 go nowhere

No more option pickers, label replies, or scrollback plans.

the loop

Comment on the plan, not the chat.

Specs, plans, drafts, reviews: the prose your agent writes deserves a real review flow, not a chat reply.

  1. 1

    The agent writes a file

    Ask for the plan as a markdown file, not an ephemeral conversation. A file is something you can open again tomorrow. A conversation gets messier. mdtation plans/auth.md

  2. 2

    You read, comment, and copy

    Press c on a line, or drag-select a sentence, and add a comment. Read and comment step by step.

  3. 3

    The agent revises, you loop

    The agent reads the comments and edits the file. Open it again: your comments are still anchored. Archive what landed, go again. mdtation plans/auth.md list

built for agents, human-first design

Meditate on the plan, then send comments back

Human-friendly notes. Mouse-enabled even as a TUI, keyboard-first , command palette and menus included.

works with anything that can CLI, or you paste manually
Claude CodeCodex CLICursor CLIAmpCopilot CLI
features

Everything a TUI should have

Keyboard-first but fully mouse friendly, adopting desktop patterns like menu bars and command palettes.

  • Caret, scrollwheel, click

    j and k move a caret, the wheel scrolls like a desktop app and the caret keeps up, and a click puts it on any row. You always know which line you are on.

  • Menu bar and command palette

    File, View, Navigate, Edit, Comments, Help in a real menu bar. / filters the same commands by title. Toggles that are already on read as Hide.

  • Narrow terminals

    Prose reflows and the menu bar collapses at phone width, so a tmux split or a small SSH session is still readable.

Frequently asked questions

read,breathe,comment,loop