Files it reads and writes
Exactly what ChatRelay touches on your PC.
| Where | What |
|---|---|
~/.chatrelay/config.json | Machine name and ID, backend, links, options |
~/.chatrelay/state.json | Per-session sync bookkeeping (hashes and sizes last pushed/pulled) |
~/.chatrelay/backups/ | Timestamped backups |
~/.chatrelay/logs/chatrelay.log | JSON-lines log (Logs panel, copyable error report) |
~/.chatrelay/queue.json | Pushes waiting for the backend |
~/.chatrelay/scan-cache.json | Scan cache (sizes, times, titles) |
OS keychain, service chatrelay | github-token, anthropic-api-key |
~/.claude/projects/… | Claude Code conversations (read; written on pull) |
~/.claude/settings.json | Only for auto-sync hooks and cleanupPeriodDays (backed up first) |
~/.codex/sessions/…, state_5.sqlite, session_index.jsonl, memories_1.sqlite, goals_1.sqlite | Codex conversations and their index (read; written on pull, only while Codex is closed, backed up first) |
<project>/.chatrelay.json | Only for non-git projects pushed from a project screen |
<project>/HANDOFF.md, CLAUDE.md, AGENTS.md, GEMINI.md | Only when you save a summary there |