Skip to content

1.9 Journal and History

Jump to bottom
Frédéric Clavert edited this page Jul 20, 2026 · 11 revisions

Journal and History Guide

Version: 1.0.0-rc.3 Last updated: 2026-07-20

Overview

ClioDeck keeps a full record of your work with the AI assistant, so you can find your way back to past enquiries and follow your own progress.

What is recorded

  • Research journal: your work sessions
  • Conversation history: past exchanges with the assistant
  • Session timeline: a chronological view
  • Context recovery: pick up an earlier conversation
  • AI proposals (RC3): every accept, reject or edit is recorded, along with the chapter it happened in

Two journals, two purposes

ClioDeck keeps two journals, deliberately separated:

Journal Contents What it is for
Research journal (brain.db) Full exchanges: questions, answers, sources, proposal texts Finding and citing your own method
AI usage journal (journal.db) Facts without content: which model, when, how many tokens, which decisions Accounting for your use of AI — without ever exposing your text

The usage journal contains no prompt, no excerpt and no file path. That is a design guarantee, not a setting. Open it with Ctrl/Cmd+J.

Research journal

Opening it

  1. Open your project
  2. Click the Journal icon in the sidebar (book icon)

Structure

The journal is organised by work sessions:

Session (2026-07-20 14:30)
├── Conversation 1
│   ├── Your question
│   └── Assistant's answer (with sources)
├── Conversation 2
└── …

What is shown

Item Description
Date and time When the session took place
Duration Time spent in the session
Exchanges Number of questions and answers
Sources consulted Documents referenced

Filtering

  • By date: show a specific period
  • Empty sessions: hide sessions without activity
  • By keyword: search within the content

Conversation history

Quick access

In the chat panel, click the History icon to see previous conversations.

Navigating

  • Conversation list: newest first
  • Preview: the opening words of each exchange
  • Selection: click to see the detail

What each exchange keeps

Item Description
Question Your original message
Answer The assistant's reply
Sources Documents used for retrieval
Timestamp Exact date and time
Model Which LLM answered (Ollama, embedded, cloud provider)

Session timeline

A chronological view of your research activity.

Jul 2026
│
├── 20 ████████ (8 sessions)
├── 19 ████ (4 sessions)
├── 18 ██ (2 sessions)
│
Jun 2026
│
├── 30 █ (1 session)
└── …
  • Hover: see the detail of a day
  • Click: filter that day's sessions
  • Zoom: week, month, year

Resuming a conversation

  1. Open the history
  2. Select a past conversation
  3. The context is reloaded

Limits

  • The retrieval context may differ if your index has changed since
  • Answers are not recomputed
  • The sources shown are the ones used at the time

Where the data lives

Everything is stored inside the project folder:

{project}/.cliodeck/
├── brain.db      # research journal, history and vector stores
└── journal.db    # AI usage journal (separate by design)

Both are SQLite databases. The two files are separate on purpose: the usage journal must be shareable — for a report, a funder, an ethics statement — without carrying any of your text with it.

Approximate size

Volume Space
100 conversations ~1 MB
1 000 conversations ~10 MB
10 000 conversations ~100 MB

Managing the history

Deleting a session

  1. Select the session
  2. Click Delete (bin icon)
  3. Confirm

Note: deletion cannot be undone.

Purging everything

  1. Settings → Database
  2. Click Purge history
  3. Confirm

Export

The AI usage journal can be exported (Markdown, JSONL, CSV) from its own window (Ctrl/Cmd+J) or with the cliodeck-journal command.

Good practice

  • Thematic sessions: group your enquiries by subject
  • Revisit: the history is where forgotten leads come back
  • Purge occasionally if the history grows very large

Troubleshooting

The history does not appear

  • The database may be missing or corrupted — check .cliodeck/brain.db
  • Or no session has been recorded yet: start a conversation

Conversations seem lost

  • Conversations are saved automatically; an abrupt shutdown may lose the last exchange
  • Check the application logs

Degraded performance

  • A very large history: purge old sessions

Access

  • The Journal icon (book) in the sidebar
  • The History icon in the chat panel
  • Ctrl/Cmd+J for the AI usage journal

Clone this wiki locally