Threads & Persistence

Every conversation is a thread, stored as a single JSON file you can inspect, back up, or delete. Nothing is hidden in a database.

Where threads live

Threads are written to ~/.agentty/threads/<workspace-hash>/, one JSON file each. The workspace hash keys them to the directory you launched in, so projects don't cross-contaminate.

~/.agentty/
└── threads/
    └── 8f3a…b2/          # hash of the workspace path
        ├── f24a29c6….json
        └── 86be6534….json⧉

Managing threads

Press Ctrl+J to open the thread list and switch between past conversations. Ctrl+N starts a new thread. Since each thread is plain JSON, you can also rm one or copy it elsewhere as a backup.

Atomic writes

Thread and credential writes are atomic: agentty writes to a temp file, calls fsync/_commit, then renames into place (MoveFileExW on Windows). A crash mid-write can't leave you with a half-written, corrupt thread.

Credentials

Auth lives separately at ~/.config/agentty/credentials.json (mode 0600) — see Authentication.