TUI Copilot Chat in the Terminal | Pieces Docs

Use Copilot in the Pieces TUI—run conversational search, browse responses, and manage chats in an interactive terminal.

Getting Started with TUI Copilot

The TUI Copilot provides a full-featured chat interface directly in your terminal. The interface is divided into three main areas: chat history, conversation window, and quick options.

Chat History

Click the `+ New Chat` button at the top of the left sidebar. This creates a fresh chat session while keeping your previous conversations accessible. Click on any chat entry in the sidebar to continue where you left off. The currently active chat is highlighted in light green. Scroll down in the sidebar to see relevant snippets and context that Copilot can reference during your conversations.

Conversation Window

At the bottom of the chat view, you can find the message bar. When you send a message, your messages will appear in blue and Conversational Search will respond in green. Check the top of chats for background information that Copilot uses to provide more accurate responses. Use the scrollbar to review previous messages and timestamps in your current chat session.

Quick Options

Type in the input bar at the bottom and press `return` (macOS) or `enter` (Windows/Linux) to send your question to Copilot. Use these shortcuts for quick access:

* **`ctrl+s`:** Toggle the sidebar on/off
* **`ctrl+n`:** Start a new chat
* **`shift+ctrl+m`:** Change the AI model
* **`ctrl+l`:** Toggle Long-Term Memory context
* **`shift+ctrl+w`:** Switch to Workstream view
* **`ctrl+p`:** Open the command palette

TUI Copilot As a Daily Driver

The TUI Copilot brings the full power of Conversational Search directly to your terminal, making AI assistance accessible wherever you work.