ClioDeck

A writing assistant for historians Un assistant d'écriture pour les historiens

Contact

ClioDeck is a local-first, AI-powered writing assistant designed for historians and humanities researchers. It combines RAG-based research, bibliography management, primary source analysis, and document editing in a single desktop application.

ClioDeck is a vibe-coding experiment by Frédéric Clavert, coded with Claude Code.

ClioDeck est un assistant d’écriture local, propulsé par l’IA, conçu pour les historiens et les chercheurs en sciences humaines. Il combine recherche par RAG, gestion bibliographique, analyse de sources primaires et édition de documents dans une seule application de bureau.

ClioDeck est une expérience de vibe-coding par Frédéric Clavert, codée avec Claude Code.

ClioDeck screenshot (light) ClioDeck screenshot (dark)

FeaturesFonctionnalités

  • RAG Research AssistantAssistant de recherche RAG Query your PDFs and sources in natural language. Every answer includes automatic source citations. Interrogez vos PDF et vos sources en langage naturel. Chaque réponse inclut des citations automatiques des sources.
  • Brainstorm ModeMode Brainstorm A dedicated chat mode for the exploratory phase of research: agent loop with tool-use, retrieval grounding across PDFs, Tropy archives, Obsidian notes and your own manuscript, and per-project context (context.md). Un mode chat dédié à la phase exploratoire de la recherche : boucle agent avec outils, ancrage RAG sur PDF, archives Tropy, notes Obsidian et votre propre manuscrit, et contexte par projet (context.md).
  • MCP IntegrationIntégration MCP ClioDeck is both an MCP client (consume third-party MCP servers from Brainstorm) and an MCP server (expose your indexed corpus to Claude Desktop or Claude Code). Inactive by default, audited via a JSONL access log, and third-party tool results are inspected before they reach the model. ClioDeck est à la fois client MCP (consomme des serveurs MCP tiers depuis Brainstorm) et serveur MCP (expose votre corpus indexé à Claude Desktop ou Claude Code). Inactif par défaut, journal d'accès JSONL, et les résultats d'outils tiers sont inspectés avant d'atteindre le modèle.
  • Archive ConnectorsConnecteurs d'archives Search Gallica (BnF), HAL (CCSD) and Europeana directly from Brainstorm or any connected MCP client. API keys (Europeana only) are stored via Electron safeStorage, never in plain text. Cherchez dans Gallica (BnF), HAL (CCSD) et Europeana directement depuis Brainstorm ou un client MCP connecté. Les clés API (Europeana uniquement) sont stockées via Electron safeStorage, jamais en clair.
  • Bibliography ManagementGestion bibliographique Zotero synchronization, BibTeX import/export, PDF indexing, and a statistics dashboard for your library. Synchronisation Zotero, import/export BibTeX, indexation de PDF et tableau de bord statistique pour votre bibliothèque.
  • Primary SourcesSources primaires Tropy integration with OCR and transcription support, in batch or one source at a time. Search across both secondary and primary sources simultaneously, filtered by collection if you wish. Intégration Tropy avec OCR et support de transcription, par lot ou source par source. Recherchez simultanément dans vos sources secondaires et primaires, filtrées par collection si vous le souhaitez.
  • Your Own Manuscript as a CorpusVotre manuscrit comme corpus What you have written is indexed alongside your sources, so you can ask what you said about a subject three chapters ago. Excerpts from your own draft are always labelled apart from your sources — you must be able to see when you are citing yourself. Settings show the index state and let you rebuild it. Ce que vous avez écrit est indexé aux côtés de vos sources : de quoi retrouver ce que vous disiez d'un sujet trois chapitres plus tôt. Les extraits de votre brouillon sont toujours distingués de vos sources — vous devez pouvoir voir quand vous vous citez vous-même. Les réglages affichent l'état de l'index et permettent de le reconstruire.
  • Corpus AnalysisAnalyse de corpus Knowledge graph visualization, textometrics (word frequencies, n-grams, TF-IDF), similarity finder, and optional topic modeling. Visualisation de graphe de connaissances, textométrie (fréquences de mots, n-grammes, TF-IDF), recherche de similarités et modélisation de thèmes optionnelle.
  • Document EditorÉditeur de documents Live-render Markdown editor (CodeMirror 6) with footnotes, Pandoc citations and citation autocomplete. Articles, books and presentations all share the same editor. Export to PDF (via LaTeX), Word (.docx) or reveal.js slides. Éditeur Markdown en rendu live (CodeMirror 6) avec notes de bas de page, citations Pandoc et auto-complétion des citations. Articles, livres et présentations partagent le même éditeur. Export en PDF (via LaTeX), Word (.docx) ou diaporama reveal.js.
  • Research JournalJournal de recherche Session tracking, chat history, and activity timeline to keep track of your research process. It can be purged, behind a confirmation that names exactly what disappears. Suivi des sessions, historique des conversations et chronologie d'activité pour suivre votre processus de recherche. Il peut être purgé, derrière une confirmation qui nomme précisément ce qui disparaît.
  • AI Usage JournalJournal d'usage de l'IA A reflexive record of your own recourse to AI: volumes, tasks and corpora, plus a manual decision layer — what non-AI alternative existed, why it was set aside, whether it was worth it. Kept in a separate database and never records your prompts. Un relevé réflexif de votre propre recours à l'IA : volumes, tâches et corpus, plus une couche décisionnelle manuelle — quelle alternative non-IA existait, pourquoi elle a été écartée, si cela en valait la peine. Conservé dans une base séparée et n'enregistre jamais vos prompts.

Design PhilosophyPrincipes de conception

  • Local-first — All your data stays on your machine
  • Your files stay yours — Plain Markdown, byte-for-byte fidelity, readable and versionable outside ClioDeck
  • Open source — Licensed under GPLv3
  • Works offline — Embedded LLM for use without internet
  • macOS & Linux — Desktop application built with Electron; a Windows build exists and should work, but is untested
  • Academic transparency — Every AI answer is traceable to its sources, and every AI edit is an explicit decision you made
  • Local d’abord — Toutes vos données restent sur votre machine
  • Vos fichiers restent les vôtres — Markdown brut, fidélité octet pour octet, lisible et versionnable hors de ClioDeck
  • Open source — Sous licence GPLv3
  • Fonctionne hors ligne — LLM embarqué pour une utilisation sans internet
  • macOS & Linux — Application de bureau construite avec Electron ; une version Windows existe et devrait fonctionner, mais n’est pas testée
  • Transparence académique — Chaque réponse de l’IA est traçable jusqu’à ses sources, et chaque modification par l’IA est une décision que vous avez prise

Get StartedCommencer

ClioDeck is available on GitHub. You’ll find the documentation on the project’s wiki.

Before you download. ClioDeck 1.0.0-rc.5 is a release candidate: usable for real work, but still under active testing. Two things are worth knowing:

  • The application is now code-signed for macOS! Gatekeeper will open it and ask you if you wish to open it on first launch.
  • Installation is still technical. A local model server (Ollama) is needed unless you use a cloud provider with your own API key, and PDF export requires Pandoc plus a LaTeX distribution. The wiki walks through it.

ClioDeck est disponible sur GitHub. Vous trouverez la documentation sur le wiki du projet.

Avant de télécharger. ClioDeck 1.0.0-rc.5 est un candidat de version : utilisable pour un vrai travail, mais encore en cours de test. Deux choses méritent d’être sues :

  • L’application est désormais signée sur macOS. Gatekeeper demandera si vous souhaitez l’ouvrir, mais ne l’empêchera pas.
  • L’installation reste technique. Un serveur de modèles local (Ollama) est nécessaire, sauf à utiliser un fournisseur distant avec votre propre clé d’API, et l’export PDF demande Pandoc et une distribution LaTeX. Le wiki détaille la marche à suivre.

ContactContact

Bugs and feature requests belong in the issue tracker, where they stay visible and get followed up. For anything else — a question, a use I hadn’t anticipated, an academic collaboration — write to .

Les bugs et demandes de fonctionnalités ont leur place dans le suivi des tickets, où ils restent visibles et suivis. Pour tout le reste — une question, un usage que je n’avais pas prévu, une collaboration académique — écrivez à .