Conversation History

Tarsk saves your messages and agent responses. Use Settings → History to browse and reopen past conversations.

Opening History

Open Settings and select the History tab.

For a quick jump to recent conversations without opening the full history page, use the History button next to the Chats heading in the sidebar.

Browsing Conversations

The history view shows conversations across projects and workspaces, with the most recent at the top. Each entry shows the project name, conversation title, and time since the last message.

Click a conversation to open it in a chat pane, including its tool calls and agent responses.

Optional columns include tokens, model, branch, and more — toggle them in the column visibility controls.

Token Usage

Each conversation entry can show token usage and the model used. This helps track API costs and understand which conversations were the most expensive.

Relationship to New Chat

Starting New Chat in a workspace creates a new conversation ID but does not delete the previous one. All conversations are preserved in history.

Export for Review

Tarsk’s built-in learn skills read recent agent runs straight from tarsk.db, so they need no export. To dump a thread or conversation as JSONL for offline review:

cd cli && bun run dump:conversation -- --thread <threadId> [--conversation <conversationId>] [--out export.jsonl]

While Tarsk is running, the same payload is available from:

• GET /api/conversations/:threadId/export
• GET /api/conversations/:threadId/:conversationId/export

Data Retention

Tarsk stores conversation history in the local SQLite database (tarsk.db). Deleting a workspace while keeping its project marks its conversation records as deleted; it does not erase those records from the database. Deleting a project-root workspace with no remaining threads also removes the project and its conversation records. Tarsk sends conversation context to your selected model provider.

Clear History

In Settings → History, open the ⋯ Choose columns menu, select Clear history, and confirm Clear. Tarsk purges conversation records and agent sessions across all projects, including records that workspace deletion marked as deleted. Your workspace folders remain on disk.

See Storage and Cleanup for observation-file cleanup and the differences between clearing history, deleting a workspace, and deleting your account.

Tips

• Use History to find solutions from earlier sessions
• Start a New Chat for each logical step to keep conversations focused
• Review token usage to understand which models and tasks consume the most tokens