Fabulist
MasonLS/fabulist
Studio de escrita com agent Claude integrado, edições aprováveis e versionamento git
Ver no GitHubStudio de escrita nativo em IA que integra Claude Code diretamente no editor de desktop. Cada documento é um projeto versionado com git, onde você pode editar manualmente ou solicitar sugestões do Claude — todas as mudanças aparecem como diffs aprováveis antes de serem aplicadas, com histórico completo e reversível.
Instalação
npx convez-ai MasonLS/fabulist1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Escrever e editar documentos com assistência de IA mantendo controle total
- Colaborar com agent Claude através de comentários ancorados no documento
- Manter histórico completo e reversível de todas as mudanças editoriais
- Gerenciar múltiplas versões de manuscritos com snapshots nomeados
Veredito

Fabulist é uma abordagem genuinamente diferente para escrita assistida por IA: coloca o controle humano em primeiro lugar com diffs explícitos e comentários ancorados, não substituição automática. Para quem escreve profissionalmente e quer um agent collaborative sem perder governança sobre o texto.
README
A tradução para o português deste README ainda está na fila.
Fabulist
An AI-native writing studio for the desktop, powered under the hood by Claude Code.
Every document is a real Claude Code project folder — versioned with git, rewindable, and shared with an agent that works inside the document's world. You write directly, or you highlight, comment, and ask Claude. Every change Claude proposes is shown to you as a diff that you approve or decline before it touches the text.

Every edit Claude proposes appears in the document as a suggested edit — strikethrough and insertion, accept or decline:

Every save, snapshot, and approved edit is a point you can return to:

Features
- A real editor first — CodeMirror 6 markdown editing with manuscript typography. Your
words live in a plain
document.mdyou can open with anything. - An agent that knows the document — chat in the sidebar; Claude reads, researches, and
edits the doc with full project context (each doc has its own
CLAUDE.mdit loads). Per-document model picker, populated live from whatever your Claude Code version offers. - Human-approved edits — Claude's proposed changes render in the document itself as Google-Docs-style suggested edits (strikethrough + insertion), with accept/decline (⌘⏎ / esc). Commands and non-document files surface as diff cards in chat. Nothing reaches the document without your explicit approval.
- Comments are the conversation — highlight text and comment, like a shared doc. Claude reads every comment, replies in the thread, and proposes any text change as a suggested edit. Threads are anchored highlights that survive edits and rewrites.
- Versioned and rewindable — autosave checkpoints, named snapshots, and automatic commits for every approved Claude edit. Preview any version as a diff and restore it; restores commit forward, so history is never destroyed.
Requirements
- macOS (Windows/Linux likely work — packaging targets exist — but are untested)
- Node.js 20+
giton your PATH- A logged-in Claude Code installation — Fabulist uses your existing
claudelogin and plan; it never asks for an API key
Run it
git clone <this repo> fabulist && cd fabulist
npm install
npm run dev
If your npm config disables postinstall scripts, run
node node_modules/electron/install.jsonce to fetch the Electron binary.
Build a standalone app (.dmg/.zip into dist/):
npm run dist
Your documents live in ~/Documents/Fabulist/, one folder per document:
~/Documents/Fabulist/<document>/
document.md ← the document itself
CLAUDE.md ← per-document instructions Claude loads automatically
comments.json ← anchored comment threads (versioned with the doc)
.fabulist/ ← app state: agent session id, chat transcript (gitignored)
.git/ ← full version history
How it works
| Layer | Choice | Why |
|---|---|---|
| Shell | Electron + electron-vite + React | The Claude Agent SDK is a Node library; running it in the main process is the most direct integration possible — no sidecar, no server. |
| Editor | CodeMirror 6 (markdown) | Baremetal; its decoration/range-mapping API powers comment highlights that survive edits. |
| Agent | @anthropic-ai/claude-agent-sdk | The actual Claude Code engine. cwd = the doc folder, resume keeps one continuous session per document, settingSources: ['project'] loads the doc's CLAUDE.md. |
| Versioning | plain git CLI per doc folder | History = git log, rewind = restore from a rev (always committed forward — restoring never erases history). |
| Approval gate | SDK canUseTool callback | Read-only tools pass through; file edits and commands surface as inline diff cards the author must approve. comments.json is app-managed and off-limits to the agent. |
The approval flow
- Claude calls
Edit/Writeon a file →canUseToolfires in the main process. - Main computes before/after, sends a permission request over IPC.
- For the document itself, the editor renders the change inline as a suggested edit (old text struck through, new text inserted) and locks the doc while you review; commands and other files show as diff cards in the chat panel.
- On accept, the SDK executes the edit; a file watcher picks up the change and the
editor updates live; the turn ends with an automatic
Claude: <prompt>commit.
Privacy
Everything is local: your documents, comments, history, and chat transcripts stay in
~/Documents/Fabulist/. Conversations with Claude go through your own Claude Code
login, exactly as if you'd run claude in that folder yourself.
Development
npm run typecheck— strict TS over main + renderernpm run build— production bundles toout/npm run pack— unpacked app build for quick smoke tests (dist/)scripts/cdp.mjs— dev harness: launch withnpm run dev -- -- --remote-debugging-port=9223, thennode scripts/cdp.mjs screenshot /tmp/app.pngornode scripts/cdp.mjs eval '<js>'(the renderer exposeswindow.__storein dev builds)
Source map:
src/main/ Electron main: window, IPC, git, library, comments store,
agent.ts (the Claude Code bridge + approval gate)
src/preload/ typed contextBridge API (window.fabulist)
src/shared/ types shared across processes
src/renderer/ React app: Library rail · CodeMirror editor (comment
decorations, selection toolbar) · sidebar (Claude chat with
approval cards / comment threads / history timeline)
See CONTRIBUTING.md before opening a PR.