Skip to main content
Every conversation is an append-only transcript you can group into projects, search full-text, fork from any turn, or trim a message at a time.

​
Quick Start

1

Group into a project

Right-click a conversation and choose Move to project to group related chats.
2

Search everything

Press ⌘K and type — the app searches every conversation’s text and jumps to the first match.
3

Fork from a turn

Fork any turn to branch a new conversation without changing the original.

​
How It Works

Transcripts are append-only JSON on disk, written with a write-then-rename pattern so a crash mid-write can never truncate an existing chat. Transcripts live at ~/Library/Application Support/PraisonAI/chats/ as one JSON file per conversation.
A transcript is written only after a run completes — never per token — so a chat app never burns through an SSD’s write endurance.

​
Actions

A corrupt transcript is surfaced in the sidebar as “(unreadable)” rather than hidden — a chat you can see is recoverable; one silently omitted looks like data loss.

​
Best Practices

A fork copies the transcript up to a chosen turn into a new conversation and leaves the original untouched — branch an idea without losing the thread.
Move related conversations into a project so the sidebar stays legible as chats accumulate.
With auto_title on, the first message becomes the chat title. Leave it on and rename only the few that need it.

Data & Privacy

Where transcripts live and how to export them

Chat & Streaming

Per-turn actions like Fork and Delete