# microsoft/terminal architecture

> Architecture diagram of the GitHub repository microsoft/terminal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/terminal
- Repository: https://github.com/microsoft/terminal

## Overview

This repository contains Windows Terminal, the Windows console host, and shared console/terminal infrastructure. A typical Terminal workflow starts with a user launching the app and choosing a profile or command, then creates a tab and terminal control connected to a command-line process; terminal input and output are parsed, represented in the text buffer, and rendered. Settings editing, tabs, panes, theming, search, and console-host functionality are separate product branches. The README documents product scope and capabilities; several runtime links below are dashed where the sampled source does not show the wiring.

Main entry points: [`src/cascadia/TerminalApp/TerminalPage.h`](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalApp/TerminalPage.h) (Terminal page), [`src/cascadia/TerminalConnection/ConptyConnection.cpp`](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalConnection/ConptyConnection.cpp) (Process connections), [`src/renderer/inc/IRenderEngine.hpp`](https://github.com/microsoft/terminal/blob/main/src/renderer/inc/IRenderEngine.hpp) (Render interface), [`src/buffer/out/textBuffer.hpp`](https://github.com/microsoft/terminal/blob/main/src/buffer/out/textBuffer.hpp) (Text buffer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Terminal application"]
  node_entry["Windows Terminal<br/>[main.cpp]"]
  node_app_logic["App logic<br/>[AppLogic.cpp]"]
  node_page["Terminal page<br/>[TerminalPage.h]"]
  node_tabs["Tabs and panes<br/>[Tab.cpp]"]
end

subgraph group_config["Settings and commands"]
  node_settings_ui["Settings editor<br/>[MainPage.cpp]"]
  node_settings["Settings model"]
  node_profile["Profile discovery"]
  node_command["Command line<br/>[Commandline.cpp]"]
end

subgraph group_runtime["Terminal runtime"]
  node_control["Terminal control<br/>[TermControl.h]"]
  node_core["Terminal core<br/>[Terminal.cpp]"]
  node_connection["Process connections"]
  node_parser["VT parser"]
  node_input_parser["Input parser"]
  node_buffer["Text buffer<br/>[textBuffer.hpp]"]
end

subgraph group_console["Console host"]
  node_console_host["Console host<br/>[server.h]"]
  node_console_api["Console API server<br/>[ApiDispatchers.cpp]"]
end

subgraph group_render["Rendering"]
  node_render_api["Render interface<br/>[IRenderEngine.hpp]"]
  node_atlas["Atlas renderer<br/>[AtlasEngine.cpp]"]
  node_legacy_render["BGFX renderer<br/>[BgfxEngine.cpp]"]
end

node_user(("Terminal user"))
node_conio["Console I/O service"]
node_shell["Command-line process"]

node_user -.->|"launches"| node_entry
node_entry -.->|"starts"| node_app_logic
node_app_logic -.->|"creates"| node_page
node_page -.->|"manages"| node_tabs
node_page -.->|"loads settings"| node_settings
node_settings_ui -.->|"edits"| node_settings
node_settings -.->|"uses generators"| node_profile
node_page -.->|"handles commands"| node_command
node_page -.->|"hosts"| node_control
node_control -.->|"delegates"| node_core
node_core -.->|"uses connection"| node_connection
node_connection -.->|"starts process"| node_shell
node_shell -.->|"sends output"| node_connection
node_connection -.->|"forwards output"| node_parser
node_parser -.->|"dispatches output"| node_buffer
node_control -.->|"translates input"| node_input_parser
node_input_parser -.->|"sends input"| node_connection
node_buffer -.->|"provides render data"| node_render_api
node_render_api -.->|"implemented by"| node_atlas
node_render_api -.->|"implemented by"| node_legacy_render
node_legacy_render -->|"requests display update"| node_conio
node_console_host -.->|"hosts API server"| node_console_api
node_atlas -->|"reads buffer"| node_buffer
node_render_api -->|"uses image slices"| node_buffer
node_input_parser -.->|"dispatches input"| node_shell

click node_entry "https://github.com/microsoft/terminal/blob/main/src/cascadia/WindowsTerminal/main.cpp"
click node_app_logic "https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalApp/AppLogic.cpp"
click node_page "https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalApp/TerminalPage.h"
click node_tabs "https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalApp/Tab.cpp"
click node_settings_ui "https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalSettingsEditor/MainPage.cpp"
click node_settings "https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalSettingsModel/CascadiaSettings.cpp"
click node_profile "https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalSettingsModel/DynamicProfileUtils.cpp"
click node_command "https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalApp/Commandline.cpp"
click node_control "https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalControl/TermControl.h"
click node_core "https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalCore/Terminal.cpp"
click node_connection "https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalConnection/ConptyConnection.cpp"
click node_parser "https://github.com/microsoft/terminal/blob/main/src/terminal/parser/OutputStateMachineEngine.cpp"
click node_input_parser "https://github.com/microsoft/terminal/blob/main/src/terminal/parser/InputStateMachineEngine.cpp"
click node_buffer "https://github.com/microsoft/terminal/blob/main/src/buffer/out/textBuffer.hpp"
click node_console_host "https://github.com/microsoft/terminal/blob/main/src/host/server.h"
click node_console_api "https://github.com/microsoft/terminal/blob/main/src/server/ApiDispatchers.cpp"
click node_render_api "https://github.com/microsoft/terminal/blob/main/src/renderer/inc/IRenderEngine.hpp"
click node_atlas "https://github.com/microsoft/terminal/blob/main/src/renderer/atlas/AtlasEngine.cpp"
click node_legacy_render "https://github.com/microsoft/terminal/blob/main/src/interactivity/onecore/BgfxEngine.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_app_logic,node_page,node_tabs,node_user toneBlue
class node_settings_ui,node_settings,node_profile,node_command toneAmber
class node_control,node_core,node_connection,node_parser,node_input_parser,node_buffer toneMint
class node_console_host,node_console_api toneRose
class node_render_api,node_atlas,node_legacy_render,node_conio,node_shell toneIndigo
```

## Components

### Terminal application

- [Windows Terminal](https://github.com/microsoft/terminal/blob/main/src/cascadia/WindowsTerminal/main.cpp): `src/cascadia/WindowsTerminal/main.cpp`
- [App logic](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalApp/AppLogic.cpp): `src/cascadia/TerminalApp/AppLogic.cpp`
- [Terminal page](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalApp/TerminalPage.h): `src/cascadia/TerminalApp/TerminalPage.h`
- [Tabs and panes](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalApp/Tab.cpp): `src/cascadia/TerminalApp/Tab.cpp`

### Settings and commands

- [Settings editor](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalSettingsEditor/MainPage.cpp): `src/cascadia/TerminalSettingsEditor/MainPage.cpp`
- [Settings model](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalSettingsModel/CascadiaSettings.cpp): `src/cascadia/TerminalSettingsModel/CascadiaSettings.cpp`
- [Profile discovery](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalSettingsModel/DynamicProfileUtils.cpp): `src/cascadia/TerminalSettingsModel/DynamicProfileUtils.cpp`
- [Command line](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalApp/Commandline.cpp): `src/cascadia/TerminalApp/Commandline.cpp`

### Terminal runtime

- [Terminal control](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalControl/TermControl.h): `src/cascadia/TerminalControl/TermControl.h`
- [Terminal core](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalCore/Terminal.cpp): `src/cascadia/TerminalCore/Terminal.cpp`
- [Process connections](https://github.com/microsoft/terminal/blob/main/src/cascadia/TerminalConnection/ConptyConnection.cpp): `src/cascadia/TerminalConnection/ConptyConnection.cpp`
- [VT parser](https://github.com/microsoft/terminal/blob/main/src/terminal/parser/OutputStateMachineEngine.cpp): `src/terminal/parser/OutputStateMachineEngine.cpp`
- [Input parser](https://github.com/microsoft/terminal/blob/main/src/terminal/parser/InputStateMachineEngine.cpp): `src/terminal/parser/InputStateMachineEngine.cpp`
- [Text buffer](https://github.com/microsoft/terminal/blob/main/src/buffer/out/textBuffer.hpp): `src/buffer/out/textBuffer.hpp`

### Console host

- [Console host](https://github.com/microsoft/terminal/blob/main/src/host/server.h): `src/host/server.h`
- [Console API server](https://github.com/microsoft/terminal/blob/main/src/server/ApiDispatchers.cpp): `src/server/ApiDispatchers.cpp`

### Rendering

- [Render interface](https://github.com/microsoft/terminal/blob/main/src/renderer/inc/IRenderEngine.hpp): `src/renderer/inc/IRenderEngine.hpp`
- [Atlas renderer](https://github.com/microsoft/terminal/blob/main/src/renderer/atlas/AtlasEngine.cpp): `src/renderer/atlas/AtlasEngine.cpp`
- [BGFX renderer](https://github.com/microsoft/terminal/blob/main/src/interactivity/onecore/BgfxEngine.cpp): `src/interactivity/onecore/BgfxEngine.cpp`

### Other components

- **Terminal user**
- **Console I/O service**
- **Command-line process**

## Connections

- Terminal user → Windows Terminal: launches
- Windows Terminal → App logic: starts
- App logic → Terminal page: creates
- Terminal page → Tabs and panes: manages
- Terminal page → Settings model: loads settings
- Settings editor → Settings model: edits
- Settings model → Profile discovery: uses generators
- Terminal page → Command line: handles commands
- Terminal page → Terminal control: hosts
- Terminal control → Terminal core: delegates
- Terminal core → Process connections: uses connection
- Process connections → Command-line process: starts process
- Command-line process → Process connections: sends output
- Process connections → VT parser: forwards output
- VT parser → Text buffer: dispatches output
- Terminal control → Input parser: translates input
- Input parser → Process connections: sends input
- Text buffer → Render interface: provides render data
- Render interface → Atlas renderer: implemented by
- Render interface → BGFX renderer: implemented by
- BGFX renderer → Console I/O service: requests display update (evidence: `src/interactivity/onecore/BgfxEngine.cpp`)
- Console host → Console API server: hosts API server
- Atlas renderer → Text buffer: reads buffer
- Render interface → Text buffer: uses image slices (evidence: `src/renderer/inc/IRenderEngine.hpp`)
- Input parser → Command-line process: dispatches input
