Help Center/ CodeArts Agent/ User Guide (IDE)/ Chat History
Updated on 2026-09-17 GMT+08:00
View PDF
Share

Chat History

Chat history is CodeArts Agent's memory of past interactions, recording the chats between a user and the AI, including previous questions, answers, and context.

Constraints

Table 1 Constraints

Category

Description

Function

Chat history is displayed by project. Do not modify project names arbitrarily, as doing so may render historical records unviewable.

Storage

Local storage.

In the opencode.db file in the %USERPROFILE%/.codeartsdoer/codearts-data directory.

Managing Chat History

  1. Log in to CodeArts Agent IDE as instructed in Quick Start.
  2. On the chat panel of the CodeArts Agent, click to view recent chat records.

    If the chat panel of CodeArts Agent is not displayed, click (Expand AI Side Bar) in the upper right corner of the top menu bar to open it.

  3. You can view the latest 10 chat records and perform the following operations.

    Table 2 Managing chat history

    Operation

    Instruction

    Viewing all historical chats

    All is displayed only when there are 10 or more historical chats.

    In the lower left corner of the Recent conversation window, click All to view the historical chats of the current project and global chats (these chats do not belong to any project and are usually generated in earlier versions).

    Viewing a historical chat

    Click a chat record in the list to open it again on the chat panel.

    NOTE:

    If you need to review chats, search for content, share information, or organize data, you can view the chat history to access the complete information.

    Editing a historical chat

    Hover the cursor over next to a chat and choose Edit to change the chat name.

    Exporting a historical chat

    Exporting historical chats is mainly used for scenarios such as backing up or sharing chat content. For example, if your chat contains important information, you can export it for local backup to prevent data loss.

    Only chats in the completed state can be exported.

    1. Hover the cursor over next to the chat to be exported and choose Export.
    2. Click the button for the export method you want.
      • Export Selected: This option exports the chat content you manually selected.
      • Export All Chats: This option exports all records under the current chat, including prompts and model responses.
      • Export All Prompts: This option exports all the prompts you entered in the current chat, excluding model responses.

      CodeArts Agent will export the required chat content in Markdown format to the local PC. The file name is in the format of CodeArts Agent YYYY-MM-DD.md.

    Copying a chat ID

    Hover the cursor over next to the target chat, and select Copy Session ID to copy the ID of this chat.

    Deleting chats one by one

    When there are few chat records, deleting them individually is not only more intuitive and flexible but also allows for the precise removal of specific content.

    1. Hover the cursor over next to the chat you want to delete and select Delete.
    2. In the displayed dialog box, click OK.
      CAUTION:

      Deleted chats cannot be recovered. Exercise caution when performing this operation.

    Batch deleting chats

    Deleting many chats one by one manually is inefficient; you can also batch delete chats using the following steps: For example, if a large number of temporary chats were generated while debugging or testing the agent, you can use the batch delete feature to clear these unneeded records with one click.

    In the Agent mode, if there are ongoing chats, batch deletion excludes chats in the Ask mode.

    1. In the lower left corner of the recent chat window, click All.
    2. Click next to the search box.
    3. In the chat list, select the records to be deleted and click Delete.

      To delete all records, scroll the list to the earliest record, choose Selected above the list, and click Delete.

    4. In the displayed dialog box, click OK.
      CAUTION:

      Deleted chats cannot be recovered. Exercise caution when performing this operation.

Related Documents

Modifying a project name will render the chat history of that project unviewable in CodeArts Agent IDE. If you need to restore your chat history, follow the instructions in What Should I Do If I Cannot View Chat History in the Original Project?