teep

Your private telepath for the agent writing your code._

You drive the agent. Teep watches the agent.

Teep rendering README.md live-preview — file tree on the left, markdown with an inline mermaid diagram on the right, keybinding table below. — Teep rendering its own README — mermaid diagram, syntax-highlighted tables, live preview, change log in the status bar.

What it is

Teep is a terminal-based file viewer built for agentic coding. Run it in a split pane next to Claude Code (or any coding agent), and it watches the repo live — syntax-highlighted source, git diffs, markdown with inline images and mermaid diagrams, all rendered beautifully in the terminal. Press n to jump to the next file the agent touched. Press u when you're caught up.

Install

Two lines.

brew install teep-app/teep/teep
teep .

Requires Ghostty (or any terminal with Kitty / iTerm2 / Sixel graphics). Inside tmux: tmux set -g allow-passthrough on. Optional: mmdc for mermaid rendering. See configuration.

Features

Live filesystem watch

Detects every write the agent makes, 100 ms debounce. Press n to jump to the next changed file, u to mark everything seen.

Beautiful markdown

GitHub-flavored markdown with inline images and mermaid diagrams. Rendered in the terminal, right next to the agent writing it.

Git-aware

Inline diff vs HEAD, status overlay, worktree switcher. All on a keystroke.

Fast

Single Rust binary, sub-150 ms cold start. No JVM, no chromium, no Node runtime.

Terminal-native

Ghostty-first. Kitty, iTerm2, WezTerm, tmux with passthrough all work. Everything else falls back to halfblocks.

Agent-agnostic

Claude Code, Aider, Cursor background edits, a script, a human. If it writes files, teep watches it.

Read the docs · Frequently asked questions · Releases on GitHub