microsoft/intelligent-terminal

microsoft/intelligent-terminal

Description: A fork of Windows Terminal with native agent integration, right in your command line.

Language: C++

License: MIT

Stars: 917

Forks: 52

Open issues: 47

Created: 2026-05-18T10:57:07Z

Pushed: 2026-06-11T02:27:46Z

Default branch: main

Fork: no

Archived: no

README:

Welcome to the Intelligent Terminal repo

Table of Contents

• [What is Intelligent Terminal?](#what-is-intelligent-terminal)
• [Installing and running Intelligent Terminal](#installing-and-running-intelligent-terminal)
• [Microsoft Store](#microsoft-store-recommended)
• [WinGet](#winget)
• [Downloads](#downloads)
• [Get Started](#get-started)
• [Keyboard Shortcuts](#keyboard-shortcuts)
• [Configuration](#configuration)
• [Features](#features)
• [Agent Status Bar](#agent-status-bar)
• [Agent Pane](#agent-pane)
• [Agent Management](#agent-management)
• [Error Detection](#error-detection)
• [Command Palette](#command-palette)
• [Data & Privacy](#data--privacy)
• [Building the Code](#building-the-code)
• [FAQ](./doc/faq.md)
• [Feedback](#feedback)
• [Contributing](#contributing)
• [Code of Conduct](#code-of-conduct)
• [Security](#security)
• [Trademarks](#trademarks)

What is Intelligent Terminal?

Intelligent Terminal is an experimental fork of Windows Terminal with native agent integration.

Intelligent Terminal works with any Agent Client Protocol (ACP)-compatible agent CLI. All you need is to install your preferred agent CLI on your PC. If you don't have a preferred agent, we'll get you setup with GitHub Copilot CLI.

Intelligent Terminal takes all the features you love in Windows Terminal such as: tabs, profiles, themes, settings, shells, and keyboard shortcuts, which all work the way you expect.

Read the announcement blog post for more details.

---

Installing and running Intelligent Terminal

> [!NOTE] > Intelligent Terminal requires Windows 10 2004 (19041) or later. You also need a supported agent CLI and subscription. GitHub Copilot is the default.

Microsoft Store (recommended)

Install the Intelligent Terminal from the Microsoft Store. This allows you to always be on the latest version when we release new builds with automatic upgrades.

WinGet

winget users can download and install the latest Intelligent Terminal release by installing the Microsoft.IntelligentTerminal package:

winget install --id Microsoft.IntelligentTerminal -e

Downloads

| Distribution | Architecture | Link | |--------------|:------------:|------| | App Installer | x64, arm64, x86 | Download |

---

Get Started

1. On first launch, choose your agent. Intelligent Terminal auto-detects several ACP-compatible agent CLIs on your machine (Copilot/Claude/Codex/Gemini). If none are found, it defaults to GitHub Copilot CLI and installs it for you via WinGet. 3. If you aren't already authenticated, the agent pane walks you through sign-in. 4. Start asking questions and using the agent pane for assistance. The agent has context on your shell output, no copy-pasting needed.

> [!TIP] > If you see "running scripts is disabled on this system" or an UnauthorizedAccess error in PowerShell, your execution policy is blocking your profile and Intelligent Terminal can't initialize shell integration. Run: > ``powershell > Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned > `` > If you run into any other issues or dependency errors, see [installing-dependencies.md](./doc/installing-dependencies.md).

---

Keyboard Shortcuts

All shortcuts are customizable through Intelligent Terminal settings.

| Shortcut | Action | |----------|--------| | Ctrl+Shift+. | Toggle the agent pane | | Ctrl+Shift+I | Switch focus to/from the agent pane | | Ctrl+Alt+. | Open agent pane with error context | | Ctrl+Shift+/ | Open agent management | | Alt+Shift+/ | Open Command Palette in prompt mode | | Alt+Shift+B | Open an interactive delegate-agent tab with no startup prompt |

---

Configuration

Everything is configurable through Intelligent Terminal settings, under "Agent" settings.

| Setting | Options | |---------|---------| | Agent and model | GitHub Copilot (default), or any ACP-compatible agent CLI, including custom or local agents. Configurable for both the agent pane and command palette. | | Pane placement | Top, Bottom (default), Left, Right | | Error detection | Allows Intelligent Terminal to automatically detect command failures | | Error suggestions | Allows Intelligent Terminal to automatically send detected errors to the agent for fix suggestions | | Agent session tracking (hooks) | Allows Intelligent Terminal to track active agent sessions and their status in the session management UI |

---

Features

Agent Status Bar

The agent status bar sits at the bottom of the window and gives you quick access to everything agent-related. On the left: the agent pane toggle (hotkey: Ctrl+Shift+.) and the error detection icon (hotkey: Ctrl+Alt+.), which lights up when a fixable error is detected. On the right: the agent management icon (hotkey: Ctrl+Shift+/) that opens your session management panel. It's a persistent, minimal control surface so you're never more than one click away from your agents.

Agent Pane

A context-aware, docked pane with your agent CLI of choice. The pane has context on your shell output across all your shells. Toggle with Ctrl+Shift+., switch focus with Ctrl+Shift+I. If the agent needs to do multiple or complex tasks, it spins up background tasks in new tabs so your active shell stays focused.

When you have multiple panes active, a small "Agent" indicator will appear on the pane that your agent has "focus" on.

Agent Management

View all active agents, their status, and past sessions. Pick up a workflow where you left off or check on a long-running task. Click the agent management icon in the status bar or press Ctrl+Shift+/ to open it.

Error Detection

When a command fails, an indicator appears in the agent status…