teep.app

What It Is

Teep is a terminal file viewer designed for agentic coding. A typical setup is a split terminal: Claude Code, Aider, or another coding agent runs on one side, while teep . runs on the other. It does not try to replace an IDE; instead, it watches file writes in the repository in real time, helping developers keep up with what the agent is changing.

Core Capabilities

Functionally, Teep focuses on “watching” and “reviewing.” It monitors filesystem changes with a 100ms debounce, lets you press n to jump to the next file modified by the agent, and u to mark a file as read. Its viewing features include source-code syntax highlighting, GitHub-flavored Markdown, inline images, Mermaid diagrams, inline diffs against HEAD, a Git status overlay, and worktree switching. It is a single Rust binary and claims cold starts under 150ms, with no dependency on JVM, Chromium, or a Node runtime.

Environment, Open Source, and Integrations

Teep primarily supports macOS and Linux; Windows is not officially supported yet. For terminals, Ghostty is the main target, with support for Kitty, iTerm2, WezTerm, Zellij, and tmux with passthrough enabled; otherwise, images fall back to halfblocks. It is not tied to any specific agent: as long as a tool writes files, Teep can watch it, including Cursor background edits, scripts, or human collaboration. The project is open source, with code on GitHub, dual-licensed under MIT or Apache 2.0, and it explicitly states that there is no telemetry, analytics, or update checking.

Pricing and Documentation

No commercial pricing or paid plan is mentioned in the main text; for now, it appears to be a free and open-source tool. The documentation is fairly complete for the 0.1.0 stage, covering installation, requirements, shortcuts, the command palette, Markdown/Git support, configuration, logs, and troubleshooting. Its limitations are also clearly stated: Mermaid requires the external mmdc tool, files larger than about 2MB fall back to plain text, and keybindings cannot yet be customized.

Pros, Cons, and Who It’s For

Its strengths are precise positioning, lightweight design, and a local-first approach, making it especially suitable for heavy terminal users who want real-time review while working with coding agents. The downsides are that it is still an early release, Windows is not officially supported, configuration options are limited, and tmux and Mermaid require extra setup. It suits developers who already use Claude Code, Aider, and similar tools in their daily workflow; if you need a full IDE, complex editing features, or a team-level review platform, Teep is not the primary choice.

Access from China

The main text does not provide information about network accessibility from China, mirrors, or payment options. Installation depends on Homebrew and the GitHub repository, so actual access may vary depending on the local network environment. Alternatives include using the Git diff features in an editor/IDE, a terminal file browser, or a custom file-watching script.