User Guide

Map the work, run real terminals and agents in parallel, see what needs your attention, and review the result without leaving the cockpit.

Getting Started

TermTree is for running many tasks at once. Lay out the work as a tree of nodes, launch a terminal into each, then use the map to track progress and know when to step in.

Mind Map

Why TermTree uses a spatial map of task nodes instead of a list, and how to create, organize, and navigate nodes in it.

Terminals

Each node can host a real terminal session that keeps running in the background. Learn how to launch, focus, navigate, and close terminals in TermTree.

Split Terminals

View multiple terminals side by side or stacked in TermTree's split terminal view — creating splits, mixing layouts, and dissolving them.

Editor & Viewer

Review an agent's work without leaving TermTree — the terminal is your file explorer, with an editor/viewer panel for reading, diffing, and lightly editing what changed.

Preview & Export

Read Markdown as formatted text, Mermaid diagrams as drawings, and HTML files as live pages — then copy or export to DOCX for people who don't have TermTree.

Quick Open

Reach a file in your agent's worktree in a couple of keystrokes — no file tree, no typed path — with breadcrumb tree, type-to-filter, git-status coloring, and per-pane memory.

Quick Search

Jump to any node in your task tree instantly by name, without scanning or scrolling — TermTree's keyboard-driven Quick Search.

Agent Awareness

How TermTree detects AI coding agents, tracks the git worktree they're working in, and knows when one is blocked waiting for you.

Session Persistence

Understand how TermTree saves and restores your mind map, terminal sessions, and application state between restarts.

Appearance

Customize TermTree's look with the Theme Gallery, tree layouts, language, and viewport controls.

Keyboard Shortcuts

Complete reference of all keyboard shortcuts in TermTree, organized by zone and function.