> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowdeck.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Import Chats

> Bring conversations you started in Codex, Claude Code, OpenCode, Cursor, or Grok Build into FlowDeck

Use **File → Import** (**⇧⌘I**) to copy conversations from an agent's own history into FlowDeck. Imported conversations become regular chats in the matching session, so you can read them and continue them without leaving the app.

Import is available when a session is selected. It reads the provider's saved history. It never starts a model turn, and it never changes or deletes the history in the provider's own app.

## What you can import

Import works with five agents:

* **Codex**
* **Claude Code**
* **OpenCode**
* **Cursor**
* **Grok Build**

An agent is unavailable in the list when its CLI is not installed ("Install this provider to import its conversations.") or when you turned it off in Settings ("This provider is disabled in Settings."). Install or enable it, then open the sheet again.

## Which conversations appear

FlowDeck lists only conversations that belong to the project you have open:

* The conversation must have been recorded in one of the project's worktrees, or in a folder inside one. For Codex, FlowDeck matches the worktree folder exactly, so a Codex conversation started in a subfolder is not listed.
* For a project that is not a Git repository, the conversation must have been recorded in the project folder or inside it.
* Conversations from other projects never appear.
* Conversations recorded in FlowDeck-managed worker worktrees are not listed.
* Codex conversations that FlowDeck created are not listed.
* Archived Codex conversations are not listed.

Each conversation goes to the session whose worktree it was recorded in, not necessarily the session you have open. The review list shows this under each title as **Session: name**.

## Import conversations

**1. Open the sheet**

Choose **File → Import** or press **⇧⌘I**. The sheet is titled **Bring your conversations along**.

**2. Choose an agent**

Click the agent whose history you want to read. FlowDeck shows **Finding your conversations** while it looks.

**3. Review the list**

Each row shows the conversation title, the folder it was recorded in, its session, and its date. Conversations that belong to the session you opened the sheet from start selected. Use **Select All** and **Deselect All**, or tick rows one at a time.

**4. Import**

Click **Import Selected** (the button shows the count). A progress bar runs while FlowDeck imports each conversation. Each row then shows **Imported**, or the reason it could not be imported.

When every selected conversation imports without a problem, the sheet closes. If any row fails, the sheet stays open, the failed rows stay selectable, and you can click **Import Selected** again.

Click **Back** to return to the agent list. Back, and **Close**, both stop an import that is still running. Conversations that were already imported stay in FlowDeck.

If there is nothing to import, the sheet says **No new conversations to import** and lets you choose another agent. If FlowDeck cannot read the history, it says **Couldn't load conversations** and gives the reason.

## What an imported chat contains

* **Title.** The provider's own title. If the provider has none, FlowDeck uses the first prompt in the conversation.
* **Messages.** The saved conversation, in its original order.
* **Model.** The model the provider's history records, when it has one.
* **Attachments.** FlowDeck copies each attachment into the chat. An attachment it cannot carry over is replaced by a line of text, `[Attachment unavailable: filename]`, and the rest of the conversation imports normally. This happens when the file is missing, is a symlink, is over the size limits, or is beyond ten attachments on one message.

Importing does not switch your current chat or open a closed session.

## Duplicates

FlowDeck remembers which provider conversations it has imported, including conversations you later archived. They no longer appear in the list. If one is still shown and you select it, the row reads **Already imported** and nothing is added.

Import is a one-time copy. If you rename, archive, or delete the conversation in the provider's own app later, the imported chat in FlowDeck does not change.

## Continue an imported chat

Open the imported chat in its session and send a message, as you would in any chat. FlowDeck asks the agent to continue the original conversation, so the agent keeps its earlier context.

If the agent cannot continue the original conversation, the saved history stays readable and FlowDeck shows how to recover.

> [!NOTE]
>
> Which conversations FlowDeck can continue depends on the agent and its installed version. Reading history and continuing a conversation are separate steps, so a chat can import cleanly and still need recovery when you send the next message.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.