- TypeScript 86.7%
- CSS 11.3%
- Nix 1.5%
- JavaScript 0.4%
- HTML 0.1%
The first line still shows straight away; a one-shot Haiku call then names the session in three or four words, like the desktop app does, unless it was renamed by hand meanwhile. The name is written to the transcript too. Settings → Name new sessions turns it off. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> |
||
|---|---|---|
| .impeccable | ||
| assets | ||
| scripts | ||
| src | ||
| .envrc | ||
| .gitignore | ||
| flake.lock | ||
| flake.nix | ||
| package-lock.json | ||
| package.json | ||
| package.nix | ||
| README.md | ||
| shell.nix | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
Fable
A desktop front end for Claude Code: sessions in tabs and splits, and a
sidebar where folders and sections nest inside each other. It runs your own
claude binary through the Claude Agent SDK, signed in with your own Claude
subscription, so usage counts against your plan, not an API key.
Running it (NixOS)
nix-shell # or: nix develop, or direnv allow
npm install
npm start # build, then open the app
npm run dev # Vite dev server + esbuild watch + Electron
npm run typecheck
FABLE_USER_DATA=/some/dir gives the app a separate profile (sidebar tree,
dock layout, settings) for testing.
Layout
src/main/— Electron main process.sessions.tsruns one Agent SDK query per live session in streaming-input mode;store.tskeepstree.jsonandlayout.jsonin Electron's userData directory.src/preload/— thewindow.fablebridge.src/main/appScheme.ts— serves the built renderer asfable-app://app/(notfile://), which tabs opened in their own window need.src/main/git.ts— the working-tree diff the Diff mod shows.src/main/pipeline.ts— which video-pipeline project a session is on and its stages, for the Pipeline mod (mods/pipeline.tsx).src/renderer/— React.Sidebar.tsx(the tree, the Archived list),dock.ts+App.tsx(dockview tabs and splits, global keybindings),SessionPane.tsx(transcript, permission, plan and question cards, composer with attachments and list continuation),sessionStore.ts(SDK messages to display items),settings.ts+SettingsDialog.tsx,keys.ts(keybinding actions and combos),mods.ts+mods/(Fable mods;mods/diff.tsxis the Diff panel).Preview.tsxshows images and pages inline;Docs.tsxdraws Markdown files (plans, cut lists) as documents in the chat and in a session's Docs panel, anddocLinks.tsmakes.mdpaths in replies open there.TabMenu.tsxis a tab's right-click menu (split, move, float, own window, close).src/shared/types.ts— the IPC contract;src/shared/settings.ts— default settings and keybindings.
Transcripts are Claude Code's own JSONL files under ~/.claude/projects;
Fable keeps only the sidebar tree, the layout and settings.json.
Mods
A Fable mod (src/renderer/mods.ts) can add dock panels opened per session,
buttons on a session's header and sidebar menu, a strip above the message
box, and handlers for keybinding actions; each can be switched off in Settings → Mods. Claude Code's own mods
are written against the CLI's claude-code mod API and can't load here, so
the useful ones are rebuilt as Fable mods.