Lite SuiteLite Suite
← Back to Docs

Terminal

Multi-terminal panel with AI agent integration and multi-agent orchestration

Overview

The Terminal panel is a full terminal emulator built into Lite Suite. It supports PowerShell, CMD, Git Bash, and WSL, with session persistence between restarts. Open multiple terminal panels and arrange them spatially on the canvas.

What makes it different: every terminal session is accessible to AI agents. An agent can read terminal output, write commands, and communicate with other agents — turning the terminal into a multi-agent orchestration backbone.

Features

  • Multiple shell support — PowerShell, CMD, Git Bash, and WSL
  • Session persistence — reopen the same terminals and working directories on restart
  • AI agent integration — AI agents read and write to terminal sessions via MCP tools
  • Multi-agent orchestration — multiple AI agents bind to separate terminals and coordinate through them

AI Agent Integration

The terminal exposes sessions to AI agents via MCP tools:

| Action | Purpose | |--------|---------| | list | Show all active PTY sessions | | register | Bind an agent ID to a terminal session | | read | Read a terminal's output (~32KB rolling buffer) | | write | Send text to a terminal | | submit | Write text + press Enter | | ctrl | Send a control character (Ctrl+C, Ctrl+D, etc.) | | create | Create a new terminal session | | destroy | Destroy a terminal session | | notify | Speak a TTS notification aloud |

Multi-Agent Orchestration

A pattern where multiple AI agents each bind to their own terminal and coordinate:

  1. Open several terminal panels on the canvas
  2. Launch a Claude Code instance in each terminal
  3. Each agent calls list to discover sessions, then register to bind itself
  4. A coordinator agent dispatches tasks and reviews work by reading worker terminals
  5. Agents communicate by writing to each other's terminals

Tested in production with 4 simultaneous Claude Code agents coordinated through a single Lite Suite workspace.

Keyboard Shortcuts

| Action | Shortcut | |--------|----------| | New terminal | Ctrl+T | | Close terminal | Ctrl+Shift+W |

Configuration

Shell profiles are managed in Settings > Terminal:

  • Display name and icon color
  • Shell executable path
  • Starting directory
  • Environment variable overrides

Session persistence is toggled in Settings — when enabled, Lite Suite restores terminal layout and working directories on launch.

Troubleshooting

A shell doesn't appear in the picker. Confirm the shell executable path is correct in Settings. If Git Bash or WSL isn't detected automatically, add the profile manually.

Agent messages going to the wrong terminal. Verify agent registrations by checking the agent registry files and cross-referencing PIDs against the list output.